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CYCLE 3 HELPFUL HINTS 


This paper describes helpful hints on how to use Cycle 3 of 
NOS/VE. It is intended to supplements rather than to replace» 
the standard NOS/VE documentation. If you have any questions or 
suggestionss please see Tom McGee or Bonnie Swierzbine Appendix 
D lists background documents and how to obtain them. 


To obtain additional copies of this document while running on 
SN101 at Arden Hiliss please type? 


SES,INTIUeLISTHINTS C2z<number of copies> 
To obtain a copy with revision bars against the Helpful Hints 
of the previous build (for Cycte 3s THIS IS NOT RECOMMENDED 
BECAUSE OF EXTENSIVE REFORMATTING), one can type3 
SESsINTIeLISTHINTS REVB C=<number of copies> 


The C parameter is optional and defaults to one. 


Update History 


Date Changes 

12/22/80 Revisions for NOS/VE Phase C 

2/12/81 Additional Revisions for NOS/VE Phase C 
6/09/81 Revistons for NOS/VE Buiid N 

6/19/81 Additional Revisions for NOS/VE Build N 
8/28/81 Revisions for NOS/VE Build oO 

11/06781 Revislons for NOS/VE Bulld P 

3/01782 Revisions for NOS/VE Build Q 

4/15/82 Revisions for NOS/VE Cycle 2 

5/01782 Revisions for NOS/VE Cycle 3 
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1.0 MAJOR CHARACTERISTICS OF THIS ByILD 


160 MAJOR CHARACTERISTICS _OF_ THIS. BUILD 


o At Build 9 the command names were updated per DAP ARH4774. In 
this and subsequent versions of this document only the nen 
command names are used, (The system still supports the old 
names except DISPLAY_FILE which is the new name for the old 
DUMP_FILE.) 


o The 05 procedure has had a parameter changeds a parameter 
addeds the way in which the validation job is run changed» and 
the names of certain files changed. 


The parameter that changed was INSTALL. It is now called KIND 
or K and may be given one of the following values: INSTALL of 
I (same as the old instatl=zyes)» NORMAL or N (same as the old 
Install=nods and RECOVER or R (same as the old 
installsrecover). The default Is RECOVER. 


The new parameter is QUICK_VALIDATE or QV which controls which 
us@rs will be validated by the validation job. If this 
parameter is omitted the validation Jjob will validate ail 
users. If specified this parameter gives one or more user 
names to be validated in addition to the users INTls INT2»s 
DEV1ls DEV2s REL1 and EVAL. 


The validation job is now created by the O08 procedure (i.e. 
it is no fonger on fille VALIDAT). Users that have their own 
versions of the validation job should now use the 
QUICK_VALIDATE parameter of the DS procedures 


Prior to this the "family user administrator” for family NVE 
was user JAN. This has been changed to user RKC since it is 
this user that maintains the validation file information on 
the 170. Thus if on a cali to ODSs the VALIDATE USERS 
parameter is given as NQ (suppressing the running of the 
validation job) the only validated user will be RKC (not 
JAN). 


The format of the file defining which users to validate has 
been changed, Instead of directly calling the 
ADMINISTER_USERS utility subcommandss a procedure tocal to the 
validation job is calied. The name of the procedure is 
VALIDATE_USER and its parameters are a user name and all of 
the utility subcommands that specify a user's attributes. The 
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password defaults to the user name appended with an X. The 
procedure's parameter name for the RING_MIN attribute is 
RING _ MINIMUM or RM. 


The names of the files installed by the DS procedure have heen 
changed. On the 180 the name changes are? 


SYSLIB --> QSFSSYSTEMLLIBRARY 
OSLIB “-> OSFSOPERATOR_LIBRARY 
SYSTEM_COMMANDS_LIBRARY ==> OSFSCOMMAND_LIBRARY 
OSLPI ~-> OSFSPROGRAM_INTERFACE_LIBRARY 
NOSVEPL —--> OSFSSOURCE_LIBRARY 
CCOMLRUN_TIME_LIBRARY ~-> CCFSRUN_TIME_LIBRARY 
MATH _RUN_TIME_ LIBRARY “—-> MLFSRUN_TIME_LIBRARY 
CY8ILJITI --> CYFSCOMPILER 

SCULIB —-> SCFSOBJIECT_LIBRARY 
SCULCOMMANDS_LIBRARY --> ‘SCFSCOMMAND_LIBRARY 
JEDIT o> TFFSE DITOR 


On the 170 side the name changes are? 


OSLPI ==>: OSFPIL 
NOSVEPL <--> OSFSL 
CCMLIB “--> CCFRTIL 
MATHLIB ==> MLFRTL 
CYBILII --> CYFIIC 
SCULTB “-> SCFOL 
SCUCLIB <--> SCFCL 
JEDIT ~-> IFFEDIT 
SYMDBG “--> DBFOL 


These file name changes should not affect anyone except the 
maintainers of these files and are mentioned here just § for 
your information, 


o Recovery of NOS/VE permanent files across deadstarts has been 
implemented. This has brought about considerable change in 
the way NOS/VE is brought upe The NVE command has replaced 
UPMYVE and the new commands SETVE»s provides a system procedure 
file for the NVE command. Enough details for the casual user 
are provided in Section 4.55 and a great deal of detail is 
provided in Section 5. 


o Permanent fiies need no tonger be explticitiy attached or 
created but may be directly accessed on at! commands as 
described in the ERS. 


It seems that many people are running into a problem on the 
syst2m concerning the use of “™“path"™ references to files. 
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Specifically, a job will “hang” if a CREATE_FILE (define) or 
ATTACH FILE (attach) command for aifile is followed by by 
another reference to the file using the "path" notation. For 
examples: 


CREATELFILE SUSER.JUNK 


COPYLFILE S$USER.JUNK NE WJUNK 


will result in the job begin hung. The reason is that there 
Is a LOCAL_LFILELNAME parameter on the create _file command 
which defaults to the name of the permanent file (Cin the 
example: JUNK)3$ but the "imoplicit™ access to the file via the 
copy_fife command uses an internally generated tocal name for 
the file. Thuss the effect is the same as the following 
command sequence on NOS: 


DEFINE s JUNK. 


2 


ATT ACHszuniqueszJUNK,. 
COP YszuniquesNEWJUNK. 


Heres the job will hang on the attach command because of 
conflicting access to file JUNK. 


On NOS/VEs explicit use of the CREATE_FILE and ATTACH_FILE 
commands is not generally necessary. For example? 


COPY_FILE »MYLFRIEND.SOME_FILE SUSER.SOME_FILE 


will Cimpticitiy) attach file SOME_FILE from user MY_FRIEND®s 
master catalogs create file SOME_FILE in my master catalog and 
copy the former into the ftatter (if SOME_LFILE already existed 
in my master catalogs it would be attached and overwritten). 


D0 NOT MIX "IMPLICIT" ATTACH/CREATE WITH "EXPLICIT" 
ATTACH/CREATE. 


If you Insist on explicitly attaching or creating files then 
USE THE LOCAL FILE NAME that you assigned via the ATTACH_FILE 
or CREATELFILE command, 


Sheldon Fewer is writing a DAP prooosing to change the default 
for the LOCAL FILE NAME parameter on the CREATE_FILE and 
ATTACH FILE commands. If sanity prevaitss this DAP will be 
approved and the problem outlined above wilt be largely 
resolved. Until! then PLEASE USE EITHER EXPLICIT ACCESS OR 
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IMPLICIT ACCESS (preferably the latter) BUT NOT BOTH!!! 


o This build of the OS supports V1.4 of the object text. All 
existing CYBIL binaries must be recompiled. Any assembier 
modules that have been converted to II text and saved on NOS 
must be reconverted. Any assembler modules that are sensitive 
to CYBIL*'s heap allocation strategy must be rewritten. 


o V1.4 object text also is source Incompatible tn one instance 
with prior versions? the value LLCSPVA for type 
LLTSADDRESS_KIND has teen renamed LLCSADDRESS and the vatue 
LLCSONE_WORDLEXTERNAL_PROC is no fonger supported. 


0 An EDI problem = exissts with respect to a file shared between 
jobs. An existing file is opened with an access mode of 
append by job A, The same file is opened with an access mode 
of read by job Be Job A extends the file and either 
explicitty closes the file or terminates. Job 8 explicitly 
closes the file or terminates. In this cases since the job 
accessing the file in read mode terminated after the job which 
extended the files EQI on the file will be reset to the 
original position and the resuitt of the extend will be tost. 


o The tong’ tines in OSLPI decks PMDCERR» PMDLQUEs PMDPREX»s 
PMDDBER» CYDRTECs LLDLHDR» LLDCADRs, and LLDPRGX have been 
shortened to 79 characters. 


o The NOS/VE Operator Faciftity thas been imptemented. It 
executes as part of the TAF control point and is accessed 
through the K display. All commands must now be entered 
through this control point and not the NVE (formerty UPMYVE) 
control point. The Operator Facility is capable of displaying. 
both a teft and right screen area simultaneously» allowing the 
operator to views, for examples the system tog and the CP 
display together. For further documentation of OGperator 
Facility commandss see Section 4. 


o The Interstate Communication Facilitys which is described in 
Section 9 of the NOS/VE ERS - Program Interface (Rev. 8&8)» has 
been imptemented. The callable subroutines described in 
section 9.3 reside in User Library LINKLIB in the Integration 
catalogs INT1ls DEV1l»s RELI» etc. NOS ftibraries SYSLIB and 
SRVLIB are also required to comolete the tftoading processe 
LDSET foader commands must be used to select these libraries. 


o Interactive Usage Restrictions: 


- When fogging in to NOS/VE (ieee HELLOsTAF etc.) do not 
enter a terminate break (CTRL t) or a pause break (CTRL 0p) 
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before the 'welcome message! appears at the terminal. A 
pause or terminate break entered before the interactive 
NOS/VE job has completed it's initialization may crash the 
system. 


- A REQUEST_LTERMINAL command in a batch job will crash the 
systems. This can happen accidently through a 
REQUEST_LTERMINAL command In aeuser prolog when the user 
runs a batch job since the prolfog is executed for both 
interactive and batch jobs. The problem can be avoided by 
making the REQUESTUTERMINAL command in the prolog 
conditional on the job type as follows? 


IF $JOB(MODE) <> "BATCH! THEN 
RE QUEST_LTERMINAL 
IFEND 


o Any product or utility that is placed in the $SYSTEM catalog 
(or any frequentiy loaded program) should be bound using the 
CREATE _MODULE subcommand of the CREATE_OBJECT_LIBRARY 
utility. This will minimize overhead associated with foading 
the product or utility. 


o Debug responds to terminal breaks when a program is being 
debugged» Howevers entering a pause or terminate break when 
debug is active (i.e. the DB/ prompt has appeared and the 
user has not issued the RUN command) will cause the task to 
terminate. 

o When sharing executabie files via permanent files (i.e. 
compiterss libraries, etc.) you should make the file an 
object tibrary via the CREATE_DBJECT_LLIBRARY utility. By 
sharing object tibraries instead of object files, the code is 


actuatly shared among all tasks using the Yibrary3; the Jibrary 
is not copied to enother segment but is executed directly. 


1.1 NOSZVE_USAGE_ EXAMPLES 


Llelel EXECUTING PROGRAMS 
PROCESS 
Create an object text file by compiling a program on NOS.» 


Then perform the following steps on NOS/VE?3 
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- Acquire any necessary libraries (which are pot quoted in text 
embedded directives) by either: 


o Attaching them from the system catalogs either explicitiy 
or via prolog 
or 
o Creating the library file via the object library generator 
or 
0 Staging the tibrary file from NOS to NOS/VE using the 
GETLOBJECT_LIBRARY command. 


- Get the fite from NO5 and convert the object text file from 
the CI data mapping to II data mapping by executing the 
CONVERT_OBJECT_FILE command. 


- Load and execute the program via the EXECUTE_TASK commands 
specifying the nec IJibraries with the LIBRARY parameter}; 
alternatively SETLPROGRAM_LATTRIBUTES may be used to include 
the ltibraries in all subsequent EXECUTE_TASK commands. 


- Stage the loadmap from NOS/VE to NOS for printing by using 
either: 


o The REPLACE_FILE command with Aé conversion mode specified 
if running on the simulator. 
or 
0 The PRINT command if running on the hardware. 


EXAMPLES 


The fottowing is an exampte command sequence for executing a 
program not requiring any libraries for loading? 


Assumptions: all modules to be loaded are contained on the NOS 
Permanent file ‘citxtrs'. 


CONVERT_OBJECTUFILE CITXTRS 
EXECUTE_TASK CITXTRS PARAMETER=*orogram parameters! 
PRINT LOADMAP 


The following is an example Command sequence for executing a 
program requiring Jtibraries for loading? 


Assumptions: the NOS permanent file ‘citxtrs' contains object 
text generated by the CYBIL CI compiler. The compiler modules 
reference procedures contained on the tibrary ‘mylib' and the 
CYBIL run-time tibrary. These tibraries have been generated on 
NOS/VE and saved on NOS, 
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GET_LOBJECTULIBRARY MYLIB 

SET -PROGRAM_ATTRIBUTES LOAD _MAP_DPTIONS=(BLOCKsENTRY_POINTsSEGMENT 
CONVERT_OBJECT_LFILE CITXTRS 

EXECUTE_TASK CITXTRS "program parameters? LIBRARY=MYLIB 

PRINT FILE LOADMAP 


lele2 CREATE OBJECT LIBRARY ON NOS/VE AND SAVE IT ON NOS 


Notes: 
o €L60170 Is NOS permanent file name for file containing CI 
object text for modules to be included in the library. 


o FITEXT180 is NOS/VE tocal file name for file containing II 
object text for modules to be Included in the ltibrary. 


o LIBRARY180 is NOS/VE tocal file name for the tibrary being 
created. 


o IL1IB170 ts NOS permanent file name for file containing the 
{ibrary., 


NOS/VE Job Commands 
CONVERT_LOBJECTLFILE IITEXT180 CLGO170 
CREATE_LOBJECT_LLIBRARY 
ADD MODULE LIBRARY=IITEXT130 
GENERATE_LIBRARY LIBRARY#LIBRARY180 


QUIT 
REPLACE_FILE LIBRARY180 ILIB170 D0C=856 


lele3 MODIFY A PREVIOUSLY SAVED OBJECT LIBRARY 


Notes: 


o ILIB170 ts NOS permanent file name for file containing the old 
library 


0 LIBRARY18O is NOS/VE local file name for file containing the 
old tibrary 


o CM0OD170 is NOS’ permanent file name for file containing CI 
object text for the new module 


Oo NEWIIMODULE Is NOS/VE local fille name for file containing II 
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object text for the new module 


o NEWLIBRARY is NOS/VE tocal file name for the tibrary being 
created 


o NLIB170 is NOS ftocat file name for new library 
NOS/VE Job Commands 


GET_OBJECT_LLIBRARY LIBRARY180 ILI8170 
CONVERTLOBJECTLFILE NEWIIMODULE CM0D170 
CREATE_OBJECT_LIBRARY 

ADDL MODULE LIBRARY sLIBRARY180 
REPLACE_MODULE LIBRARY=NEWITMODULE 
GENERATE LIBRARY LIBRARY=NEWLIBRARY 
QUIT 

REPLACE_L FILE NEWLIBRARY NLIB170 0C #856 


1ele4 ROUTE AN INPUT FILE FROM NOS T9 NOS/VE 


Running from an interactive terminal» enter: 


GETs filename, 
ROUTEsfilenamesDC=LP »sFC &RH. 


The input fide which is sent to NOS/VE must be in 6/12 ASCII 
{or display code subset). The job file must be aie single 
partition NOS record containing NOS/SVE commands. The first 
statement must be a vatid LOGIN command with users, password = and 
famity name specified. Multi partition input files are not 
supported by NOS/VE so NOS data files used by the program must te 
Obtained through the GET_FILE command. 


121.5 PRINT A NOS/VE FILE 


At NOS/VE job termination the job tog witt be automatically 
returned to NOS, The job tog will be appended to the NOS/VE 
output file OUTPUT. NOS/VE print files must be written by BAM as 
8/8 ASCII RT#V. Print files will be converted from 8/8 ASCII 
RTsV to NOS 8/12 ASCII when they are sent to NOS and will be 
printed in upper/lower case. 


All NOS/VE output files wil! appear In the NOS output queue 
(NOS H»sO display) with the name IRHFxxx as a banner. In order to 
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print a NOS/VE files the following command must be issued within 


your job or be entered from the system console via the operator 
facility: 


PRINTLFILE filename 
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200 COMMAND _INTEREACE STATUS 


2e1 ACCESS_TO.NOSZVE_IN_ DUAL STATE 


2ele1 LOGIN TO NOS/VE 


To initially fogin to NOS/VE via TAFs you must cause the first 
login attempt to fail. This can be done by responding to the 
“FAMILY:" togin prompt with something tikes "sss", This must be 
done because the system will try to connect the terminal to IAF 
on the first togin attempt no matter what is typed. To access 
TAF do the following on the second "FAMILY:" prompt: 


suserspasswor ds TAF 


You can access TAF from IAF by doing “HELLOsTAF™ or by 
answering TAF to the system prompt "APPLICATION:*, 


2ele2 TERMINAL USAGE 


1) The stant (/) is the promot to enter a NOS/VE command. Any 
normal NOS/VE command can now be entered (continuation 
lines are prompted with ee/)- The full ASCII character 
sets lower or upper case and al! special characters, can be 
used. 


2) A LOGOUT command will cause the NOS/VE Interactive Job to 
terminate. A new NOS/VE Interactive Job can then be 
started by responding to the "APPLICATION? * prompt with 
TAF. 


3) Terminal breaks (controf-t and control—p) can be used to 
terminate a task or command and suspend a task and enter a 
new task to process SCL commands. Control-t causes a 
terminate break and control-p causes a pause break. 
Terminate break will terminate a command or the most 
recently executed task, A pause break will suspend 
execution and ailow commands to be entered. When a 


Cycie 35 May 1982 


2-2 
NOS/VE Cycle 3 Helpful Hints 
220 COMMAND INTERFACE STATUS 
20 el. 2 TERMINAL USAGE 


Ce Be Be ee Be he Ko Bend Ke Red thee Rati De ig Die De Bae Kea deter adicn Aertel nt, Eadie Moto Ma Es Ko Ao Ae Bi Dn Ee Re cee An tte te dita tithe a tad tetera dtd adadiiad 


terminal is in pause break state, two additional commands 
are available: 


RESUME COMMAND —- resume execution at the point of 
interruption. 


TERMINATE _COMMAND -—- cause a terminate break condition as 
a terminates break had been entered. 


Both terminate break end pause break are available to programs 
as conditions via the program management condition mechanism. 


2el.3 NOS/VE PROGRAM ACCESS TO THE TERMINAL 


1) Interactive NOS/VE jobs are able to obtain terminal input 
through the AMPSGET_NEXT or AMPSGET PARTIAL prograr 
interface which can be used by both task services and user 
ring progr amse Interactive programs which use this 
interface should be abfie to handle both upper and tower 
case input in order to make them more convenient to use in 
both 64 and 96 character set modes. 


202 COMMAND. AND. PARABETER_NAMES 


During the next few months a command supported by the systern 
may not be In sync with your command interface document. The 
parameter descriotor tabie gives an accurates concise description 
of the command interface as currentiy supported. | 


POT. Beadec!ts Guide 


The definition of a command's parameter list is enctosed in 
parenthesis with a parameter description per Iine. Each 
description has the general form: 


PARAMETER NAMES ALLOWED PARAMETER VALUES = PARAMETER DEFAULT 
VALUE 


Parameter Names - describes the parameter name and any 
abbreviations. 


ALLOWED PARAMETER VALUES - describes the kind of value allowed 
and whether a fist of values Is possible. The value kind can be 


Cycle 3, May 1982 


2-3 
NOS /VE Cycle 3 Heipful Hints 
2.0 COMMAND INTERFACE STATUS 
Ze2 COMMAND AND PARAMETER NAMES 


further qualified. In some casess the actual vatues atlowed are 
described using the KEY notation. The vatue kinds include 
INTEGER, STRINGs NAME» FILE» STATUS. 


PARAMETER DEFAULT VALUES - describes the defaulting rules 
and/or values for the parameter. $REQUIRED and $0PTIONAL are 
obvious. Other values in this position wilt be treated as if 
they were entered by the user on command invocation. 


See the PROC command in the Command Interface ERS for more 
details. 


The POTs for the commands currentiy in the system can be 


displayed using the DISPLAY_COMMAND_INFORMATION command. This is 
documented in the nonstandard command section of this document. 


203 COMMAND EUNCTIONS 


Eunctlon atatus 

$MOQD unchanged 
$CHAR unchanged 
$CLOCK unchanged 
$DATE unchanged 
S$FILE unchanged 
SFNAME unchanged 
$INTEGER unchanged 
SNAME unchanged 
$ORD unchanged 
SREAL unchanged 
SSTRING unchanged 
$STRLEN unchanged 
SSTRREP unchanged 
S$SUBSTR unchanged 
SUNIQUE unchanged 
STIME unchanged 
$VAR unchanged 
SSPECIFIED unchanged 
$SET_COUNT unchanged 
SVAL UE_ COUNT unchanged 
SRANGE unchanged 
SPARAMETER LIST unchanged 
S$PARAMETER unchanged 
SSTATUS unchanged 
$CONDITION unchanged 
SSEVERITY unchanged 
SPROCESSOR unchanged 


Cycie 35 May 1982 


2—4 
NOS/VE Cycie 3 Helpfyl Hints 
2¢0 COMMAND INTERFACE STATUS 
223 COMMAND FUNCTIONS 


roa 4 Ei Bi Mi Ee Me Ree he Be he Bid Ke Me Rede Mn Roden de Eaten he he ede hy he A Mehndi lin dinthe Aidindie Aiding dnd 


$J08 unchanged 
S$PROGRAM unchanged 
SYSTEM ACCESS. COMMANDS 

Commands atatus 
SETL_LINK_ATTRIBUTES unchanged 
LOGIN unchanged - ¥*1 
LOGOUT unchanged 

SET PASSWORD unchanged 


The family name of the job doing the submit will 
the default family name on batch jobs. 


submitted from NOS wiit be famjly SSYSTEM. 


RESOURCE MANAGEMENT 
Cannanogd atatus 
REQUEST TERMINAL unchanged 
EILE_MANAGEMENT 
Command status 
SETLFILE_ATTRIBUTES unchanged 
COPY_FILE unchanged 
OLSPLAY_FILE unchanged 
COMPARE_FILE unchanged 
DISPLAY FILE_ATTRIBUTES unchanged 
SKIP_TAPE unchanged 
PERBMANENT_EILE_ MANAGEMENT 
Command atatus 
GETLFILE unchanged 
REPLACE_FILE unchanged 
unchanged 


CREATE_FILE 


Cycle 3» 


The default for jobs 
effectively 
means that whenever NOS/VE jobs are submitted from NOS the 
family parameter is required, 


NOS /VE 
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ATTACH_FILE 
DELETE_FILE 
CHANGE_CATALOG_ENTRY 
CREATE_FILE_PERMIT 
DELETE_FILE_PERMIT 
CREATE_CATALOG 
DELETE_CATALOG 
DELETE_CATALODG_PERMIT 
CREATE_PERMIT_CATALOG 
DISPLAY_CATALOG 
DISPLAY_CATALOG_ENTRY 
SET_WORKING_CATALOG 


SCL_SLATESENTIS_AND_ PROCEDURES 


Comnaod 


PROC /PROCEND 

SET _COMMAND_LIST 
DISPLAY_COMMAND LIST 
REPEAT/UNTIL 

WHIL E/WHILEND 

CREATE _VARIABLE 

DELETE VARIABLE 

BLOCK/ BLOCKEND 

LOOP /LOOPEND 
FOR/FOREND 
IF/ELSEIF/ELSE/SIFEND 
CYCLE 

EXIT 

WHEN /WHENEND 

CONTINUE 

CANCEL 

INCLUDE_FILE 
COLLECT_TEXT 
DISPLAY _ VALUE 

EXIT PROC 

ACCEPT_LINE 
INCLUDE_LINE 
CREATE_FILE_CONNECTION 
DELETE_FILE CONNECTION 
DISPLAY_FILE CONNECTION 
change HCS variable 
disotay HCS variable 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


Status 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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209 INTERACTIVE COMMANDS 


Command Status 
RESUME_COMMAND unchanged 
TERMINATE _ COMMAND unchanged 
SET LTERMINAL_ATTRIBUTES unchanged 
DISPLAY_TERMINAL ATTRIBUTES unchanged 
2210 OBJECT CODE MAINTENANCE 
Cosnand Status 
CREATE _ OBJECT LIBRARY unchanged 
DISPLAY_NEW_LIBRARY unchanged 
SELECT_DISPLAY_ OPTION unchanged 
ADD. MODULE unchanged 
REPLACE MODULE unchanged 
COMBINE _ MODULE unchanged 
CREATE MODULE unchanged 
BIND_MODULE unchanged 
CREATE PROGRAM DESCRIPTION unchanged 
DELETE_MODULE | unchanged 
CHANGE _MOOULE_ATTRIBUTE unchanged 
SATISFYLEXTERNAL_ REFERENCES unchanged 
REORDER_ MODULE unchanged 
GENERATE_LIBRARY unchanged 
DISPLAY_OBJECT_LIBRARY unchanged 
COMPARE_OBJECT_LIBRARY unchanged 
QUIT unchanged 
CI to II Conversion unchanged 
2e1l1 USER_SERVICES 
Command Status 
DISPLAY_LOG unchanged 
DISPLAY MESSAGE unchanged 
2012 EILE_.RQUTING 
Comnand atatus 
HCS JMROUTE removed 
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2013 PROGRAM_EXECUTION 


Command . atatus 

SET -PROGRAM_ATTRIBUTES new ~ *3 
DISPLAY_ PROGRAM unchanged 
EXECUTE unchanged 
“name cait®™ unchanged — *1 
TASK /TASKEND unchanged 
TERMINATE_TASK unchanged 

WAIT unchanged 

SET DEBUG_RING unchanged 
DISPLAY_ACTIVE_TASKS new ~- ¥*2 


*1 Warning - “name cal!" works only for SCL procedures unless a 
FILE command has been issued to specify that the 
FILE_CONTENTS are OBJECT and the FILE_ORGANIZATION is DATA or 
LIBRARY. The FILE command must be reissued every time the 
file is brought over from NOS. The CONVERT_LOBJECT_LFILE>, 
GET_OBJECTLFILEs and GET_OBJECT_LIBRARY nonstandard commands 
issue the appropriate SET_LFILE_ATTRIBUTES command and are 
therefore recommended. 


*2 Replace HCS TSTATUS command. 


*3 Replaces SETLOBJECT_LIST and SET_PROGRAM_OPTIONS commands. 


214 JOB_MANAGEMENT 


Command status 

SUBMIT_ JOB unchanged 
DISPLAY_JOB_LSTATUS unchanged 
TERMINATE_JGB unchanged 
PRINT_FILE © unchanged 
TERMINATE _ PRINT unchanged 
DISPLAY PRINT_STATUS unchanged 


2015 NOS ZVYE_COMMANOS IMPLEMENTED _AS_ PROCS 


In this builds several NOS/VE commands have been implemented 
as SCL procedures in order to make the system look more tike the 
final version. Users are urged to use these procedures rather 
than their interim counterparts since the interim commands will 
ultimately be withdrawn. 
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These procedures will be made available via the default system 
prolog. 


2216 NON_STANDARD. COMMANDS 


The following commands provide a nonstandard means of 
performing various frequentiy performed functions. They will be 
superceded in subsequent bulids by standard commands. and 
capabilities, 


201501 DELETE _CATALOG_CONTENTS : DELCC (NEW) 


The purpose of this command is to delete all entries from the 
specified catatog. This includes subcatalogs and the files they 
contain. 


delete_catalog contents [catalog=<cata log>] 
Cstatus=<status varlable>] 


catalogic: This parameter specifies from which catalog ali 
files are to be deleted, Omission will cause 
the current working catalog to be used, 


status? See ERROR HANDLING. 
2016.2 DISPLAY _ACTIVE_TASK ¢$ DISAT (NEW) 


The purpose of this command Is to display task statistics for 
all currentiy active tasks in a job. The folfowing information 
is displayed. 


task name 
execution time use 
number of page faults 


dispiay_active_task Coutput=<file>] 
{Cstatus=<status variable>] 


outputio: This parameter specifies the file to which the 


task statistics ts displayed. Omission will 
cause $OUTPUT to be used. 
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201623 DISPLAYLSYSTEMLDATA { DISSD (NEW) 


The purpose of this command is to display system page fault 
statistics and system monitor request statistics. 


display system data [display_optionspage faultsipf 
tmonitor_requestsimrial! 
Cdisplay_formatz=incrementalilitotalit] 
Coutput=<file>] 
Cstatuse<status variable>d] 


display _optionido: This parameter specifies which 
statistics are to be disptayed, The 
following options are allowed 3: 


page _ faults ~ display the page 
fault statistics. 


monitor requests - display the syster 
monitor request 
statistics. 


Omission will cause ALL to be 
used» 


display_formatidf: This parameter specifies whether a 
display of the all statistics recorded 
so far (total) or onty those statistics 
recorded since the last 
display _system_data command 
(incremental) should be displayed. 
Omission wilt cause incremental to be 


used. 
outputio? This parameter specifles the file to 
which the system data will be 


displayed. Omission will cause SOUTPUT 
to be used. 
status? See ERROR HANDLING. 


201524 DISPLAY_JOB_LDATA + DISJD (NEW) 


The purpose of this command is to display the following job 
related statistics: 
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time in job mode 

time in monitor mode 

count of page in operations 
reclaimed pages 

new pages assigned 

working set size 

count of ready tasks 


display. job data [disp!iay_option® job_data] 
Cdisplay_formatzincrementaliittotalit] 
Coutpute<Ffile>d] 
Cstatuss<status variabie>] 


display_optionido: This parameter specifies which 
statistics are to be displayed, The 
Following options are allowed: 


job data - display job related data. 


Omission will cause job data to be 
used, 


display _formatidf: This parameter specifies whether a 
disptay of the atl statistics recorded 
so far (total) or only those statistics 
recorded since the tast display _job_data 
command Cincremental ) should be 
displayed. Omission will cause 
incremental to be used. 


output! of This parameter specifies the file to 
which the job data will be displayed. 
Omission will cause $OUTPUT to be used. 


status: See ERROR HANDLING. 
201665 DISPLAY_COMMAND_INFORMATION : DISCI 


The purpose of this command is to display current information 
about a NOS/VE command. The parameter names, abbrevietionss 
allowed values and known problems for a commands as supported in 
the current systems can be determined. This is a nonstandard 
command and wilt be replaced by the help utility sometime in the 
futures 


display _command_information command _names<name>i alt 
Cutility_namezcreate_ob ject library! 
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colisource_code_utility}scuisystem] 


Cdisplay_option=parameter_description_tablei 


pdtinotesinamesi help] 


Coutput=<file referenced] 
Cstatuss<status variable>] 


command onamei cn: 


utility nameiun3 


displ ay_optioni: do: 


outputio: 


status: 


This parameter specifies the name of the 
command about which information is to be 
displayed. 


This parameter specifies which utility the 
command betongs toe Omission wilt cause 
SYSTEM to be used. 


This parameter specifies the type of 
display being requested. The options are: 


parameter_description_tableipdt - selects 
a display of the parameter descrip- 
tion table used by the command wher 
executed, 


notes —- selects a display of any known 
problems with the command. 


names —- selects a display of the command 
names for a utility. 


help - satects a display of the command 
interface description of the command. 


Omission will cause PDT to be used. 
This parameter specifies the file to which 
information wit! be displayed. Omission 
will cause SOUTPUT to be used. 


See ERROR HANDLING. 


221626 CONVERT_LOBJECTLFILE { CONOF 


The purpose of 


this command ts to get a NOS/VE object file 


produced on NOS and to convert it to an object file suitable for 


processing by the 
commands. 


NOS/VE toader or object code maintenance 


convert_object_fite tos#<file reference>d 
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{frome<name>] 
Cuser=<name>] 
Cstatuss<status variabled] 


to3}t: This parameter specifies the NOS/VE file name on 
which the converted object file is to be written, 


fromif: This parameter specifies the name of the NOS file to 
be converted. This is the permanent file name as 
defined in the NOS file system and can be up to seven 
characters in length. 


Omission will cause the permanent file name of the 
TO parameter to be used. 


useriut: This parameter specifies the NOS user identification 
of the owner of the file. This parameter ts anly 
Neccessary if the file is in a catalog other than the 
user who was specified by the most recently issued 
SETLLINK_ ATTRIBUTES command. 


status? See ERROR HANDLING. 
2016.7 GETLOBJECTLFILE | GETOF 


The purpose of this command is to get a previously converted 
NOS/VE object file from the NOS side and sets the appropriate 
file attributes that will allow the object file to be used by 
NOS/VE. 


get_object_file tos#<file referenced 
Cfrom=s<name>d] 
Cuserz<name>] 
Cstatus=<status varlable>] 


to{t: This parameter specifies the NOS/VE file name of the 
object file. 


fromif: This parameter specifies the NOS file name of the 
object file. This ts the permanent file name as 
defined in NCS and can be up to seven characters in 
length. 


Omission witl cause the permanent file name of the 
TO parameter to be used. 


userius This parameter specifies the NOS user Identification 
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of the owner of the file. This parameter is only 
necessary if the file is in a cataiog other than the 
user who was specified by the most recently issued 
SETLLINK_ATTRIBUTES commande 


status: See ERROR HANDLING. 
2216.8 GET_LOBJECT_LLIBRARY ! GETOL 


The purpose of this command is to get a previousiy created 
NOS/VE object library from the NOS side and set the appropriate 
file attributes that will allow the object ftibrary to be used on 
NOS/VE. 


get_object_tibrary toz<file reference> 
Cfrome<name>] 
Cuser=<Cname>] 
Cstatusz<status variable>] 


tot: This parameter specifies the NOS/VE file name of the 
object library. 


fFromifs: This parameter specifles the NOS fite name of the 
object file. This is the permanent file name as 
defined in NOS and can be up to seven characters in 
fength. 


Omission will cause the permanent file name of the 
TO parameter to be used. 


useri:ut This parameter specifles the NOS user identification 
of the owner of the file. This parameter is only 
necessary if the file is in a catalog other than the 
user who was specified on the most recently Issued 
SET_LINK_LATTRISUTES command. 


status: See ERROR HANDLING. 
201669 DISPLAY_OBJECT_TEXT $ DISOT 


The purpose of this command is to produce a formatted display 
of the object text conteined in an object file or object tibrary 
produced on NOS/VE. 
display_object text files#<file> 
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Cfoutput#<file referenced] 
Cstatus=<status variable>] 


filezfs This parameter specifies the object file or object 
library containing the object text to be listed, 


outputio: This parameter specifies the file to which the 
display is to be written. 


Omission wilt cause the file $OUTPUT to be used. 
status: See ERROR HANDLING. 


2016210 EDITLFILE : EDITF 


The purpose of EDIT FILE is to initiate the execution of the 
SCU editor ona text fite. {For detaits see ARH3883.) 


edit file § editf - edit lines on a source file. (procedure file 
not necessarily in its final form) 


Racateters defaults 
filezfile source) $REQUIRED 
Cresultefile(Csource)] $VALUE (FILE) 
Cinputefite reference ] SCOMMAND 
Coutputefile reference] SOUTPUT 
Cstatus] 


2016.11 JEDIT 


The purpose of this command is to initiate execution of the 
JEDIT editor bulit by Jack Bohnhoff. Anyone wanting Information 
about the editor should contact Jack. 


jedit from=<file> 
{statuss<status variable>] 


fromif: This parameter specifies the file to be editted. 
This file is rewritten after the editor 
terminates, 

status: See ERROR HANDLING in the NOS/VE Command 
Interface. 
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2016012 DEBUG 


2016212 DEBUG 


The prototype R1 NOS/VE debugger is now available. Details on 
how to use the debugger can be found in the “CYBER 18¢ 
INTERACTIVE DEBUG External Reference Specification and User's 
Guide™s Sunnyvale DCS number $4028, 


2016213 SETLLINKLATTRIBUTES + SETLA 


The SETLLINK_ATTRIBUTES command is the same as documented in 
the NOS/VE command interface with the exception that the CHARGE 
and PROJECT parameters are optional (and in fact not useful in 
the current environment since we disable that feature on the NOS 
side), 
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The *status! 
unchanged from the previous builds 
build or not 


cotumn 


available 


within each section. 


3e1 COMMAND PROCESSING 


whether 
modified 
in this bulld. 


indicates 


the 
from 


05/24/82 


procedure 


the previous 
Footnotes are numbered 


Procedure atatus 
CLPSSCAN_PARAM_LIST unchanged 

CLPSTEST PARAMETER unchanged 
CLPSGET_KEYWORD unchanged 
CLPSGET_SET_COUNT unchanged 
CLPSGET_VALUE_ COUNT unchanged 
CLPSTEST_RANGE unchanged 

CLPSGET_ VALUE unchanged 

CLPSCREATE_ VARIABLE updated to ERS Rev. 8 
CLPSDELETE_VARIABLE updated to ERS Reve 8 
CLPSREAD_VARIABLE updated to ERS Reve. 8 
CLPSWRITE_ VARIABLE updated to ERS Rev. & 


CLPSSCAN_COMMAND_FILE 
CLPSEND_SCAN_COMMAND_FILE 
CLPSSCAN_COMMAND_LINE 
CLPSCREATE_FILE_CONNECTION 
CLP$DELETE_FILE_ CONNECTION 
CLPSPUSH/POP_UTILITY 
CLPSGET_COMMAND_ORIGIN 
CLPSGET_DATA_LINE 
CLPSSCAN_PROC_DECLARATION 


MESSAGE. GENERATOR 
Procedure 


OSPSFORMAT_MESSAGE 
OSPSSET_USTATUS_ ABNORMAL 
OSPSAPPEND_STATUS_PARAMETER 
OSPSAPPEND_STATUS_INTEGER 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


atatus 


unchanged 
unchanged 
unchanged 
unchanged 
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3-3 RESOURCE MANAGEMENT 
Procedure atatus 
RMPSREQUEST_MASS_STORAGE unchanged 
RMPSREQUEST TERMINAL unchanged 


Ali terminal attributes can be soecified on the 


RMPSREQUEST_TERMINAL call but only the following are operational? 


auto _ input 
transparent. mode 
prompt file 
prompt ustring 


oo0°0 


Files assigned to a terminal 


following BAM requests: 


o AMPSOPEN 
o AMPSGET_LNEXT 
o AMPSGET_DIRECT 
o AMPSGET_PARTIAL 
o AMPSPUT_NEXT 
o AMPSPUT_DIRECT 
o AMPSPUT_PARTIAL 
o AMPSCLOSE 
o AMPSREWIND 
o AMPSSKIP 
o AMPSSEEK_DIRECT 

34 PROGRAM_ EXECUTION 
Pcocedure atatus 
PMPSEXIT unchanged 
PMPSEXECUTE uNchanged 
PMPSTERMINATE unchanged 
PMPSAWAIT_ TASK _ TERMINATION unchanged 
PMPSMODULE_TABLE ADDRESS unchanged 
PMPSENTRY_POINT_TABLE_LADDRESS unchanged 
PMPSPUSH _TASK_ DEBUG_MODE unchanged 
PMPSSET_TASK_DEBUG_MODE unchanged 
PMPS TASK DEBUG _MODE_ON unchanged 
PMPSSET_ DEBUG RING unchanged 
PMPSDEBUG_RING unchanged 
PMPSCHANGE DEBUG _LIBRARY_LIST unchanged 
PMPSPOP_ TASK _DEBUG_MODE unchanged 


device can be accessed via the 
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3.5 


326 


37 


PROGRAM COMMUNICATION 
Procedure 


OSPSAWAIT_ACTIVITY_COMPLETION 
PMP$DEF INE_QUEUE 
PMPSREMOVE_QUEUE 
PMP$CONNECT_QUEUE 

PMPSDI SCONNECT_QUEUE 
PMP$SEND_TO_QUEUVE 
PMPSRECEIVE_FROM_QUEUE 
PMP$STATUS_QUEUE 
PMPS$STATUS_QUEUES_DEFINED 
PMPSGET_QUEUE_LIMITS 


COND IIITON. PROCESSING 
Procedure 
PMPSESTABLISH_CONDI TION_HANDLER 


PMP$DISESTABLISH_COND_HANDLER 
PMP$CAUSE_CONDITION 
PMPSCONTINUE_TO_CAUSE 
PMP$TEST_CONDITION_HANDLER 
PMPSVALIDATE_PREVIOUS_SAVE_AREA 
PMPS$ES TABLISH_DEBUG_OFF 
OSPSSET_STATUS_FROM_CONDITION 


PROGRAS_SERVICES 
Procedure 


PMPS GENERATE_UNI QUE_NAME 
PMPS$GET_TIME 
PMP$GET_MICROSECOND_CLOCK 
PMPSGET_TASK_CP_TIME 
PMP$GET_DATE 
PMP$GET_USER_IDENTIFICATON 
PMPSGET_ACCOUNT_ PROJECT 
PMP$GET_JOB_NAMES 
PMPS$GET_JOB_ID 
PMP$GET_JOB_MODE 
PMPSGET_PROGRAM 
PMP$GET_TASK_ID 
PMPSMANAGE_SENSE_SWITCHES 
PMP$GET_OS_VERSION 


Status 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


atatus 


3=3 


05/24/82 


Added support of detected 
uncorrected error 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


status 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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PMPSGET_LPROCESSORLATTRIBUTES 


PMPS$ DEF INE_DEBUG_ENTRY 
PMP$GET_DEBUG_ENTRY 

PMPSMODIFY_DEBUG_ENTRY 
PMPSREMOVE_DEBUG_ENTRY 


LOGGING 
Procedure 


PMPSLOG 
PMPS$LOG_ASCII | 


EILE MANAGEMENT 
Procedure 


Sequential Access 
Byte_Addressable Access 
Record Access 

Segment Access 

VUSystem Speci fied 
ViUser Specified 
U_System Specified 
ULUser Specified 
F_System Specified 
F_User Specified 
AMPSDESCRIBE_LNEW_FILE 
AMPSFILE 
AMP$GET_FILE_ATTRIBUTES 
AMPS$FETCH 

AMPSSTORE 
AMPS$COPY_FILE 
AMPSRENAME 
AMPSRETURN_FILE 
AMPSOPEN 

AMPSCLOSE 


AMPSFETCHLACCESS_INFORMATION 


AMPSSKIP 

AMPSREWIND 
AMPSWRITELEND_ PARTITION 
AMPSGET_NEXT 
AMPS$GET_DIRECT 

AMPSGET_ PARTIAL 

AMPS PUT_NEXT 
AMPSPUT_DIRECT 

AMP$ PUT_ PARTIAL 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


itatus 


unchanged 
unchanged 


atatus 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
deleted 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
new name 
unchanged 
unchanged 
unchanged 
unchanged 
*2 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
uNchanged 


unchanged — *3. 


*1 
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*1 


*2 


*3 


AMPSSEEK_ DIRECT unchanged 
AMPSGET_SEGMENT_POINTER unchanged 
AMPSSET_SEGMENT_EOI unchanged 
AMPSSET_SEGMENT_ POSITION unchanged 
AMPSSET_ LOCAL. NAME_ ABNORMAL unchanged 
AMPSSETLUFILE_LINSTANCE_ABNORMAL unchanged ; 
AMPSACCESS_ METHOD unchanged 
AMPS$ FETCH FAP POINTER unchanged 
AMPSSTORE_FAP_ POINTER unchanged 


Segment access If a segment access file is written and an 
AMPSSETLSEGMENT_EDI is not issued to record the E0I,» EDI 
remains zeroe The highest page referenced is not yet used as 
the default EGQI. This particularly affects those who wish to 
make heaps permanent because FOI is always zero for a heap. 


AMPS$REWIND The WAIT parameter on the procedure call is not 
supportede 


AMPSPUT_PARTIAL PUT_PARTIAL with the TERM _GPTION = 
AMCSTERMINATE does pot act as a put next if a preceding START 
was not issued. 


3010 PERMANENI_ELLE_MANAGEMENT 


Procedure atatus 

PFPS$ DEFINE updated to ERS Rev. 9 
PFPSATTACH updated to ERS Reve 9 
PFPSPURGE updated to ERS Reve. 9 
PFPSCHANGE updated to ERS Rev. G 
PFPSPERMIT updated to ERS Rev. 9 
PFPSDELETE_PERMIT updated to ERS Reve 9G 
PFPSDEFINE CATALOG updated to ERS Reve 9 
PFPSPURGE_CATALOG updated to ERS Rev. 9 
PFPSPERMIT_ CATALOG updated to ERS Reve 9 
PFPSDELETE_CATALOG_PERMIT updated to ERS Reve 9 


3011 MEMORY MANAGE SENT 


MMPS ADVISE_IN unchanged 
MMPSADVISE_OUT unchanged 
MMPS ADVISE _OUT_IN unchanged 
MMPSWRITE_MODIFIED_PAGES unchanged 
MMPSCREATE_ SEGMENT unchanged 
MMPSDELETE SEGMENT unchanged 
MMPSSTORE_SEGMENT_ATTRIBUTES unchanged 
MMPSFETCH_SEGMENT_ATTRIBUTES unchanged 
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ell MEMORY MANAGEMENT 


MMPSVERTIFY_ACCESS unchanged 

MMPSFREE unchanged 

MMPSLOCK_PAGES number of locked pages per 
MMPSUNLOCK_PAGES segment restricted to 32 
MMPS FETCH PVA_UNWRITTEN_ PAGES unchanged 


3012 STAILSTIICS FACILITY 


SFPSESTABLISH STATISTIC unchanged 
SFPSENABLE_ STATISTIC unchanged 
SFPSDISABLE_STATISTIC unchanged 
SFPSDISESTABLISH_STATISTIC unchanged 
SFPSEMIT_USTATISTIC unchanged 
SFPSEMIT_USYSTEM_ STATISTIC unchanged 


3013 INTERACTIVE EACILITY 


TFP$ TERMINAL unchanged 
IFPSFE TCH TERMINAL unchanged 
IFPSSTORE_TERMINAL unchanged 
IFPSGET_DEFLT_TERMINAL_ATTRIBUTES unchanged 
ITFPSGE TU TERMINAL ATTRIBUTES unchanged 
IFPSADVANCE new - *1 


*1 Only the option IFCSADVANCE_ALL_ QUEUED_OUTPUT is supported. 


3014 NOSZVE EXCEPTIONS 


The fottowing summarizes the exception code ranges currently 
assigned to NOS/VE. These code ranges represent a finer 
breakdown than the one specified in the SIS for tnternal NOS/VE 
development purposes. Howevers it is important to remember that 
onty the product identifiers documented in the SIS may appear iin 
error mess agese 


Common Modules 99000 - 959999 
Common Code Generator 82000 - 89999 
Product 
Exception Code Identifier Product Name 
1 - 1583999 Reserved 
159,000 = 159,999 SY System Core 
1602 000 ~ 16959999 AM Basic Access Methods 
1602000 - 1632999 BA Basic Access 
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1643000 - 1643999 LN Local Name Mgr 
1653000 ~- 165,999 JF Job File Mor 
1663000 - 1665999 SR Conversion Services 
1672000 - 167999 CM Configuration Mgmt 
1709000 - 17939999 CL Command Language 
1802000 =- 189,999 JM Job Management 
1902000 =- 199,999 LL Loader 
2002000 = 2093999 MM Memory Management 
2002000 = 20439999 MM Monitor Level 
2052000 —- 2053999 MM Task Level 
2102000 - 21953999 os Operating System 
2102000 - 2109999 os os 
211,000 - 21159999 MT EXEC 
21229000 = 21239999 10 MS 1/70 
2132000 =- 2133999 10 Tape 1/0 
2149000 — 2149999 DM Device Management 
2153000 - 2153999 ML Memory Link 
21639000 = 2165999 IF Interactive 
2172000 — 2173999 TM TM Monitor 
21829000 =- 21859999 ™ ™ Task 
21929000 =- 21959999 J5 Job Swappers 
2209000 =- 2293999 PF Permanent File 
Management 
2212000 - 22129999 ST Set Management 
2229000 = 2229999 PU Permanent File Utilities 
2302000 =- 2395999 PM Program Management 
2402000 = 2499999 RM Resource Management 
2502000 =- 2599999 OF Qperator Facility 
2609000 = 2693999 AV User Administrator 
2709000 - 2793999 Ic Interstate Communication 
2809000 - 2893999 RH Remote Host Facility 
2909000 =- 2999999 oc Object Code Utilities 
3003000 = 3099999 DB Deadstart/Recovery 
3109000 - 3193999 MS Maintenance Services 
3202000 — 32959999 Reserved 
3402000 — 3499999 SF Statistics Fac. 
3302000 =- 33939999 US User Errors 
5002000 =- 5093999 AA Advanced Access Method 
5102000 - 5193999 AG ALGOL 
5202000 - 5293999 AL Assembly Language 
5302000 - 5393999 AP APL 
5402000 = 5499999 BA BASIC 
5502000 =~ 55953999 CA Conversion Aids System 
56023000 =— 5699999 CB COBOL 
5702000 =- 5793999 CY CYBIL 
5802000 - 5899999 FT FORTRAN 
5902000 =~ 5999999 PA PASCAL (Wirth) 
6002000 = 6099999 Pl PL/1 
6102000 = 6193999 SM Sort Merge 
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6203000 - 629,999 SC Source Code Utility 
64029000 - 649,999 DB Debug 


Cycle 39 May 1982 


4-1 


NOS/VE Cycle 3 Helpful Hints 


05/24/82 


4.0 DUAL STATE DEADSTART AND OPERATION 


400 DUAL _STATE_DEADSTART_AND_ OPERATION 


4ol CURRENT _OUAL STATE CONFIGURATION 


The 


Arden Hills $2 development systems are configured to run 


with three FMD units. 


o FMD Unit 43 


This unit contains the following: 


A170 NOS (5.3 as released)» CTI» MSL» EI binariess NOS 
deadstart files 

FRles associated with user name LIBRARY 

Fites associated with user name SES 

Files associated with DEV1ls»s DEV2»s REL1l», INTI. 


o FMD Unit 41 


This unit contains the followings: 


Files required to ceadstart dual state Cycle 33; A170 NOS 
(5.3 plus changes necessary for Cycle 3)» CTI» MSL» EI 
binartess and NOS Deadstart files. 
It is also used as a temp device. 


o FMD Unit 42 


-. 


This unit contains the following: 


NOS/VE Development Area PL*s and Member PL*s 

NOS/VE Deadstart Files to be tested (saved in individual 
user*®s catalogs) 

Files associated with user name INT2 


o FMD Jnit 44 


This ts another NOS PF device. 


o FMD Unit 45 


This is another NOS temp device. 
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402 USER NAMES AND PERMANENT FILES 


1) The convention used for creating user names on NOS/VE is as 
follows? 
o Your user name will be your Initials. 
o Your password will be these 3 Jetters followed by the 
fetter 'x, 
o You must see COMSOURCE (R.K- Cooper - x3092) to be 
assigned a user index 


2) PF dumping and loading 


You may use "“"SES.DUMPPF™ on SN/101 to dump your permanent 
flies to tapes and then toad them onto your user name on A17C 
NOS using “SES.LOADPE™. Documentation on how to use these SES 
procedures and what their parameters are is inctuded in the 
SES Users Guides, or they can be obtained by typing: 


SESsHELP.DUMPPF and SES»sHELP.LOADPF. 


4-3 TO_RELOQAD CONTROLWARE FOR THE NOS/ZVE_DISK DRIVER 


At deadstart time NOS will automatically toad 7155-1x disk 
controlware on one channel with controller type=xFM (LBC CMRdeck 
entry)s and will automatically ltoad 7155—-4x disk controlware on 
any channel with controtier tyoezHT (LBC CMRdeck entry). NOS/VE 
supports both of those types of controtiers. NOTE: It is not 
possible to use 844 halfe-track controlware in this environmente 


40% Al7ZQ_NOS_DEADSTART 


404-1 CTI AND CHECKING CENTRAL MEMORY 


Deadstarting A170 NOS assumes some knowledge of CTI. CTI 
stands for Common Test and Initialization. It is software that 
Places an 800 serfes machine in a state such that it is possible 
to deadstart an operating system, CTI ts used somewhat 
ambiguousty in the software community to impty CTI and MSL 
(Maintenance Software Library). The MSL is a collection of 
programs and data that includes such things as a subset of CMSE 
(Cyber Maintenance Software Executive) that enables one to load 
controtware to controllers, took at CYBER 180 maintenance 
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registers,» fook at microcodes etc. The MSL also contains 
microcode that can be toaded by CTI. The MSL is actually an 
operating system that runs independently of NOS. An important 
elemant of CTI/MSL is HIVS (Hardware Verification Sequence)» 
which is a program that toads microcodes clears and checks 
central memory and tests all 170 opcodes. If you are not sure 
what the machine was used for (particularty the first hands on 
user each morning) then the HIVS program should be rune This is 
accomplished by: 


1) deadstart to NOS/VE (unit 40 for $3» unit 41 for $2) 
2) Enter 0 Coperator intervention) 
3) Enter P (deadstart panelsmake sure ftevel 0 deadstart) 
4) <BKSP> 
5) Enter H fassure yourself that CS*YES to retfoad microcode) 
6) <BKSP> 
7) Enter V (verification sequence) 
8) Hit <CR> at "parameter disptay' to test CM & CP 
When you see text that tells you that verification is complete 


and a deadstart is required», you are now ready to deadstart NOS. 


4.4.2 NOS DEADSTART 


See Section 3.3 of the Integration Procedures Notebook § (for 
pha deat NOS CMRDECK changes. 
Set the D/S panel to deadstart from the primary system disk. 
This ts Unit 41 for all Cycle 2 systems. 
o Push D/S button 
Enter (CR) 
Enter date/time 


oo 


Wait for deadstart to complete. 


Note: The deadstart tape DUAL34 (which is currentiy instailed on 
unit 41) is found in the area in the northeast corner of the S2 
lab where the tape cabinet is found. 
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4e4e3 INITIALIZING AN 885 


If an 885 is powered down (processor) it may be impossible to 
deadstart or even run the HIVS programe The reason is that 
powering up does not master clear the maintenance channel. This 
is a known problem and is being addressed by CDED. The way to 
solve this problem currently is to used the CMSE equivalent of 
the HIVS program, That program can be executed by performing an 
alternate deadstart to the engineer'*s/CE*s CMSE packs entering M 
(to select maintenance), entering a CR at the menu screens and 
then entering "60 INIT39'. INIT39 is a CMSE command buffer and 
will require about 2 to 3 minutes to compiete. When the display 
shows a "TB (terminate buffer) the initialization is complete. 
The 39 stands for a microcode cycies ieee. the 885 is currently 
using cycie 39 microcode. 


405 NOSZVE_DEADSTART_AND_INSTALLATION 


o Enter DOWNsCH2. so NOS/VE can use the channel. 
o Enter DOWNsCH32. so NOS/VE can use the channel. 


o The following file must be availabte in your catalog on the 
$23 


TPXXXK contains a NOS/VE deadstart image. This must be a copy of 
the dual state deadstart images available from the Jink 
procedures. 


o If you've never deadstarted NOS/VE from the user number § from 
which you want to run or if you wish to change the current 
parameter settings for your oarticular user numbers then do a 
SETVE. SETVE assumes the file TPXXXK is in your user number 3 
you do not have to do another SETVE if TPXXXK has changed 
since the last time you rane The general form of SETVE Is? 


X-SETVECPN=Ff Ff, UN=unsC=6) 


where Ffff is an identifier of up to 4 characters and un is 
the user number to search first for files. 6 is the number of 
the system core command deck for the Arden Hilts 
configuration. In general ffff and un will be the sames eege 
XeSETVE (DAHs UN=DAH,C #6) 


**Only ONE SETVE should be done for each user number and a 
SETVE should NOT be done for ANY Integration user number 
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except by the Integration project.** 
SEE SECTION 5.1 FOR MORE DETAILS. 

o 8ring up dual state: 
NoNVE FFF. 


where n is any control point number except 1,2 and the 
BATCHIQOs MAGNET & SYSTEM control points and ffff is the 
identifier specified in SETVE,» eege “%eNVEINTI. 


o Bring up the Operator Facility 


Enter ks2 - where 2 is the contro! point of the TAFNVE 
job. 


NOS/VE is currently generated and initialized on both NOS 
and NOS/VE. All source and object libraries that make up the 
NOS/VE system are produced on NOS and therefore must be 
converted from their Cr to II counterparts. Other parts of 
instatiing and Initializing the system (esege bullding the 
$SYSTEM catalog) are performed by command language procedures 
on NOS/VE. Since the same system will many times in a closed 
shop environments it Is advantageous to only perform the 
conversion from CI to II a singie time; save the results in 
the NOS file system and then simply bring the files back 
during deadstart. 


The actual files that get installed and toaded on each 
deadstart are determined by a command tanguage procedure (the 
system profile) interpreted on NOS/VE. This procedure can be 
modified by each site to initialize their NOS/VE environment 
in the most suitable fashion. The process of building the 
system profile and of performing the CI to II conversions is 
referred to as an tinstallation deadstart and the process of 
executing the system profite and of fetching previously 
converted files from NOS and making them available in the 
NOS/VE file system is referred to as a deadstart. A singte 
command ts avallable to perform both an Installation deadstart 
and a deadstart. 


4e5.1 THE DS PROCEDURE 
The purpose of this command Is to perform an installations 
normal or recovery deadstart of NOS/VE. The defaults for 
parameters are those most convenient for “closed shoo" 


deadstarts. 
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The procedure "brings up” the Job log display on the teft 
screen where the progress of the procedure nay be watcheds and 
the control point display on the right screens Just before 
the procedure changes the teft screen to display the system 
fog and writes to that log the message: 


teo-— Deadstart Compiteted ----'! 


at which point the operator may enter commands, 


ds C€kindzinstali t norma? i recover j 
Cget_source_libraries=<boolean>] 
Ca9et_products=<boolean>] 
Cechoex<boolean>] 
CLatternate_userz<NO0S_user name>] 
Csave_instalt_files=<boolean>] 
C(validate_users=<boolean>] 
Cdebug=<booleand] 

Cfhelpe<file referenced] 
{statuss<status variable] 


kind $ kt This parameter specifies what kind of deadstart is 
to be performed. Vatid specifications are 


instal} ! i =~ installation deadstart to be performed, 
The system libraries are buift from CY object 
files. 


normal { n —- normat deadstart to be performed. The 
system Jtibrartes are obtained from the results of a 
previous installation deadstart. 

recover i! r ~- recovery deadstarte. Just initiates system 
tasks. Permanent files are "recovered™ from a 
previous run of the system. 


Omission will cause a recovery deadstart to be 
performed. 


get_source_ftibraries { gstt This parameter specifies whether 
SCU libraries are to be installed. Valid specifications 
are? 
true ? yes $ on = libraries are to be installed 


faise $ no {i off - tibraries are not to be installed 
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On the Arden Hilts closed shop $2 systems the SCU 
libraries to be instatted are? 


OSFPIL => OSFSPROGRAM_INTERFACE_LIBRARY:? operating system 
program interface 


OSFSL —> OSFSSOURCE_ LIBRARY: subset of operating system 
source fibrary 


Omission will cause SCU libraries to be Installed. 
get.-products i gp: This parameter specifies whether the object 
libraries defining the current product set are te be 
installed, Valid specifications are? 
true i yes ${ on — the products are to be installed 


faise } no $ off - the products are not to be installed 


On the Arden Hilts closed shop $2 systems the product 
set to be instattled consists of: 


CYFIIC => CYFSCOMPILER: cybit II compiter 


CCFRTL => CCFSRUN_TIME_LIBRARY3 common compiler modules 
run time library 


MLFRTL -> MLFSRUN_TIME_LIBRARY?: math run time tibrary 
DBFDL =-> DBFSDEBUG_LIBRARY? symbolic debug library 
SCFOL =-> SCFSOBJECT_LIBRARY: source code utility 


SCFCL -> SCFSCOMMAND_LIBRARY: source code utitity 
"stand-alone* command Ilbrary 


IFFEDIT ~> IFFSEDITOR: Sack Bohnhoff's editor (JEDIT) 
Omission will cause the product set to be Installed. 
echo }{ e: This parameter specifies whether the commands should 
be echoed to the console during execution. Vatid 
specifications are? 
true ¢ yes § no - echo commands 
false $! no ! off - do not echo commands 


Omission will cause commands not to be echoed. 
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aliternate_user $ aut This parameter specifies what NOS user to 
check if the default NVE user does not have the needed 
file. Any NOS user name is allowed. 


Omission will cause INT1 to be used. 
save_instali files ! sif: This parameter specifies whether to 
Save the system tibraries created by an instaltiation 
deadstart. This parameter is Ignored for a normal or 
recovery deadstart. Valid specifications are: 
true ! yes i no - save the installed system libraries 


fatse ; no : off =- do not save the instalted syster 
fibraries 


Omission will cause the files not to be saved. 
validate_users : vut This parameter specifies whether to run 
the job that validates NOS/VE userse This parameter is 
lgnored for a recovery deadstart. Valid specifications 
are? 
true : yes $: no ~ run the vatidation job 
fatse } no : off —- do not run the validation job 
Omission wit!l cause the validation job to be run. 
quick validate { av: This parameter determines which users 
will be validated by the validation job if it is run. 
When specifieds this parameter gives a tist of user names 
to be yalidated in addition to the users: INTls INT2»s 
DEVis DEV2s REL1s EVAL and RKC. 
Omission wilt cause all users to be validated. 
debug $ d: This perameter specifies whether the procedure 
shoutd abort if an error condition itis detected. Vatid 
specifications are: 
true $$: yes $: no - do not abort on an error. The user 
will be prompted for commands in the event of an 


error at which time enterrring "continue" will cause 
processing to resume. 


faise i no $ off - abort on an error 
Omission will cause the procedure to abort when an 
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error is encountered. 


help $! ht This parameter specifies whether help information is 
to be written. If this parameter Is specifieds the help 
information will be written to the specified file and the 
procedure will terminate. 


Omission wilt cause the procedure to execute and the 
heto information not to be written. 


status! See ERROR HANDLING In the NOS/VE ERS. 


If you change any of the following decks you MUST use the 
installation deadstart from your own catalog (with files 
CYBILGOs, XLJOCM» XLJOSL» XLJILIB and XLJEC)» or you must use 
the alternate user parameter to specify a NOS catalog 
containing the files (e.g. DEVI). 


AVMUTIL CLMOP DMMDISA ICMCLOS ICMFAI ICMFAPC ICMFLSH ICMGET 
ICMOPEN ICMPUT ICMWEOP IFMEXEC LTIMA7T2H TIMDC2S IIMRLE 

TIMRSE IIMRUM TIMRUSM LTIMTDEL OCMADD OCMBIM OCMBIM OCMCOL 
OCMCOM OCMCPY OCMCRM OCMDEF OCMDEL OCMDLB OCMDNL 

ODCMDOL OCMEND OCMGEN OCMLCH OCMLMNG OCMLP OCMMUR 

OCMNP OCMOBJ OCMOFH OCMOMS OCMRCH OCMRED OCMREP OCMRMB 
OCMSAT OCMSOL OCMVEL OCMVLU OCMVOL PFMDC PFMTALL 

PUMBCAT PUMBCYC PUMBFIL PUMBFO PUMBLST PUMBPF PUMBSET 

PUMCOMN PUMCRAK PUMPURG PUMCRAK PUMIOBF PUMLIST PUMMISC 

PUMPURG PUMRALL PUMRCAT PUMREC PUMREF PUMRFIL PUMRPF 

PUMSTUB RHMLML RHMQAT RHMQOP RHMQRE RHMSFM USORT UTMDUR 
UTMPCL UTMPC2 UTMPC3 UTMPC4 UTMPC5 UTMTSA UUSERI 


4.5.2 EXAMPLE OF NOS/VE INSTALLATION DEADSTART 
Type 


Ke2e where 2 is the TAFNVE control point number. 
KeSETLA Cyour_unsNVE) your_password 

KeGETF DS Usscat 

KeDS INSTALL GSL*NO GP2NO AUzscat 


4.5.3 EXAMPLE OF NOS/VE "NORMAL® DEADS TART 
The Integration system has had the installation deadstart 
runon ite Aliso the files produced by the Installation 
deadstart have been made semi-private and are found on the 


catalog used in the NVExxxx call. 
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Type (where DEV1 is the same as the xxxx in the NVExxxx 


call)3 

Ke2-e where 2 is the TAFNVE contro! point number. 
KeSETLA (CDEVIsNVE) DEVIX 

KeGETF DS 


KeDS NORMAL 


42524 EXAMPLE OF NOS/VE RECOVERY DEADS TART 


This Is the kind of deadstart that should most frequentiy 
be done In a “closed shop*™ environment and consequently is the 
one for which allt the parameter defaults are oriented. It 
presupposes that permanent file recovery has been successful. 


Type (where DEV1 is the same as the xxxx in the NVExxx x 


cait): 

Ka2e where 2 is the TAFNVE control point number. 
KeSETLA (DEVI»sNVE) DEV1X © 

KeGETF DS 

KeDS 


40505 EXAMPLE OF MINIMAL NOS/VE DEADSTART 


The minimal deadstart shown below may be useful to OS 
developers who need to get the system up quickiy and do not 
need the product set or all validated users. 


Type 


Ka2e where 2 is the TAFNVE control point number. 
<eSETLA (your_unsNVE) your_password 

KeGETF DS Usscat 

KeDS NORMAL GSL*®NO GP#NO QV2your_un AUsscat 


405-6 USE OF THE QUICK_DEADSTART COMMAND 


This command is intended as a development tool to 
facilitate "fast* deadstarts where recovery is not needed; 
indeeds if this command is entered rfesovery will not be 
performed when the system is brought down for whatever 
reason. Specifying this command witl cause an installation 
deadstart to take place. If the INITOD command ts not 
specified then a default value of "VSNOO01* is used for the 
system deadstart device. Use of INITDD will allow setting the 
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deadstart devices identifier to any value. THIS COMMAND WILL 
NOT BE ACCEPTED FROM A DEADSTART COMMAND FILE. 

Format? QUICKDS or QUICK_DEADSTART 

Values: The default is false. Executing this command 
causes this initial value to be toggled» thus executing this 
command twice will cause the final value to be false. 

Notes QUICK LU TEMPLATE_LOAD does not exist now. 


4e6 NOSZVE_INTERACTIVE FACILITY OPERATION 


4.601 OPERATOR INITIATION 
To bring up the NOS/VE Interactive facility do the 
following: 
1) Bring up NOS/VE. 
2) Bring up NAM 
At the system console enter: 


3eNAMS2., for S2 
3 eNAMS3. for $3 


3) If TAF is not up at contro! point l» enter? 
IAF. 
4) Bring up A170 part of interactive: 
TAFNVE. 
Control point two must be free or rolloutable (i.e. NAM 


should not be there). This atso brings up PASSON»s the 
Operator Facilitys and the MLI subsystem control points. 


4.62 OPERATOR TERMINATION 
To terminate NOS/VE interactive any of the following may be 
done? 


- 3.CFO.DIsAP2TAF. (3 Is the NAM control point number ) 
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This ts the preferred method. To bring NOS/VE interactive 
back ups you must first do a 3eCFOLEN»s AP=TAF, 


3eCFOe.DIsNE. (3 Is the NAM control point number) 


This terminates the entire network including IAFsRBFs etc. 


4.6.3 OTHER OPERATOR CAPABILITIES 


-_-- 


To togicailty turn the printer ony under DSD enter? 


ON33- 
FORM339TM.e 


To send a “shutdown warning” to all terminats togged on to 
TAF do? 


3e-CFO~ID» AP=TAF. (3 Is the NAM control point number) 
To send a message to all terminals do: 


3.CFO.WMSGsALL »message. (3 is the NAM control point 
number) 


PaASSON has the ability to record various types of 
diagnostic information. This capability Is controttied via 
the sense switches at the PASSON contro! point. To turn a 
sense switch on (off) at control point N do? 


NeONSWX. (N.OFFSWX.) 


Where X Is the destred sense switch (1 to 6). The PASSON 
defauit is ali sense switches of fe It will take a short 
period of time before PASSON detects a change in a sense 
switch and reacts to ite The sense switches currently used 
by PASSON are? 


suitch # use 
1 Network Trace 
2 PASSON Logic Trace To Dayfile 
3 Memory Link Trace To Dayfile 
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4.7 NOSZVE_ OPERATOR FACILITY AND OPERATOR. COMMANDS 


With the release of the Operator Facility Phase 1 several 
Changes to the NOS/VE Operating System will occur that will 
effect the users of the NOS/VE Operators Console. The 
Qperator Facility runs as part of the TAFNVE control point. 
This controt point will wait for NOS/VE to become active 
(i.e. the job monitor is initialized in the system job and 
SCL Is ready to ask for a command. When the request for K 
display appears on the NOS 8 Displays assign the K Disptay to 
the Operator Facitity/TAFNVE Control Point. AIl commands must 
be entered from this contro! point and not from the NVE 
Subsystem control point. The Operator Facility is capable of 
displaying both a teft and aright screen area at the same 
time. If the operator wants both screens then type in KK. 
The contents of these displays are determined by the commands 
entered by the operator. 


The left screen is divided into four different areas. The 
top most area is the system header which contains the current 
date and times memory statisticss and an operator action 
message if one is posted. The operator action wit! include 
the job sequence number of the owner of the message and 
‘message canceiled* if the message Is cancelled because the 
task has terminated. The next line contains the first 64 
characters of the operator action message (60 characters in 
stand alone). 


The next area of the screen is the main output area. This 
area has the file name of OUTPUT. <Any display command can 
have its output directed to this area as well as any system 
command. 


The third area is towards the bottom of the screen. This 
area is two tines tong and contains the response areae This 
will contain error messages from system commands. The area is 
cleared when the next operator typein is entered at the 
operator*®s console and received by NOS/VE. 


The fourth area is the promot area. This will contain the 
status of the keyboard. If NOS/VE is processing a commands 
then the keyboard is locked and all typeins will be tgnored. 
When the keyboard is tockeds the message ‘data received by 180 
- keyboard tocked* will appear at the screen's bottom. When 
the keyboard is unlocked then any data in the keyboard buffer 
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will be sent to NOS/VE. The bottom tine is the tast line that 
was processed by Operator Facillty. 


The right K Display has the file name OUTPUT_RIGHT. There 
is only one area on the right screen therefore the main 
dispiay area is 10 tines longer than the teft screen area. If 
a dayfite display or CP display is shown on the right screen 
you wit! get more tines of information than on the teft 
screens. 


There are no default displays that come up automatically on 
either output display area. It is up to the operator to 
decide the display the operator wishes to see» The onty parts 
of the disptay that come up automatically is the system header 
disptay and the prompt area for keyboard status. 


The Page width of the screen is 60 characters for 
Standalone and 64 characters for dual state, The character 
set translation code is the same as that for the current NVE 
Subsystem control point. The escape code sequence for the 
special characters to be typed has not changed. There are a 
few differences in the processing of data by the Operator 
Facility and NVE Subsystem. 


1) Do NOT end commands with a period. Periods are sent to 
NOS/VE. 


2) The NVE subsystem commands that begin with an asterisk will 
not be supported from the Operator Facility control point. 
If these commands are entered from the Operator facility 
they will be passed on to SCL where an illegal command will 
be Issued. 


3) Routing of console job data to a specific job by the 
*nacommand*® protocol! will not be supported in dual state. 
This feature should work in standatone but will not be 
supported. 


&) No type ahead —- commands cannot be entered until the prompt 
area shows that they are requested. 


There is one new command to replace the current display 
commands. The entry points for Zdiss Zdisbs» and Sdis have 
been deteted. The new command is VEDISPLAY and has two 
parameters, The options are tisted below. The values in 
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paranthesis are the abbreviations. Note that this command 
does not begin with an asterisk (*). This command will be 
processed by SCL and create a new system control point task to 
dispiay it*"s data. The user can have the same display type on 
each of the display areas, if the user so desirese 


Command Name Display Type Screen Area 
Parameter Name Parameter Name 
DISPLAY_OPTIONS OUTPUT (0) 


DISPLAY_OPTION (pO) 


Parameter Values Parameter Values 
VEDISPLAY (VED) DISPLAY_SYSTEM_LOG OUTPUT 
JOBL_LOG (JL) OUTPUT_RIGHT (OR) 


CONTROL_POINT (CP) 
The default file name for ali dispiays is OUTPUT. 


The following is a brief list of commands to bring up NOSVE 
with the Operator Facility installed. 


TAFNVE. to bring up ML/ICN/OFs RH and Interactive. 
noNVETT CF. to bring up NOS/VE. (See Section 5) 

Ka2e 2 = contro! point for TAFNVE. 

KK» to bring up the K display on both = screens. 
KeVED JL to bring up the job loge 


or 
KeVED DISPLAY_OPTIONS#JL OUTPUT=O0UT PUT 
to bring up the job tog using key word 
identifiers. 


KeVED CP OUTPUT_RIGHT 
to bring up the contro! point display on 
the right screen. 


or 
KeVED DISPLAY_OPTIONS*CONTROL_POINT OuUTPUTs2OUTPUT_RIGHT 
to bring up the control point display using 
key word 
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identifiers. 


K eo XXX send any command to NOS/VE. 

: 

Kone to set the K display to the NVE control 
point. 

Ke TERMINATE_LSYSTEM_JOB to terminate NOS/VE. 


Notet After the OS procedure has completed execution the 
command to enter to bring down the system is 
TERMINATE LSYSTEM_JOBs not TERMINATE_SYSTEM. 


4e7ol DELETE _JOBLQUEUE | DELETELJOBLQUEUES | DELYQ (NEW) 


The purpose of this command is to detete all files from the 
Job input subcatalogs the print subcataiog or both. This 
command is only allowed from jobs with operator and or system 
priviteges. 


delete _ job queue Cqueue_namezinputi outputialti) 
{status=<status variabte>] 


gqueue_name § qn? This parameter specifies from which 
subcatalogs files are to be deleted. Specifying 
INPUT wil! cause at! files to be deleted from the 
job swap subcatalog and the job input subcatalog. 
Specifying OUTPUT will cause all files to be deleted 
from the job output subcatalog. Omission wil! cause 
alt to be used. 


Status: See ERROR HANDLING. 
&e.7.2 REBUITLD_LINPUT_QUEUE $ REBIYOQ (NEW) 


The purpose of this command is to rebuild an entry in the 
Known Job List (KJL) from information in the System Label of 
the fille representing the job being processed. This command 
is to be used during the process of recovering the input 
queues during recovery deadstart. 


rebul ld tneut_queue [namez<name>] 
Cstatuse<status variable>] 
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name i nt This parameter specifies the file name of the 
Pile representing the Jjobe An attempt is made to 
process the specified file within the catalog where 
job input queues are known to reside. 


Status: See ERROR HANDLING. 
4.7.3 REBUILD_OUT PUT_CUEUE !? REB80Q (NEW) 


The purpose of this command is to rebuild an entry In the 
Known Output List (KOOL) from information retained in the 
System Label of the file representing the output being 
Processed. This command is to be used during the process of 
recovering the output queues during a recovery deadstarte 


rebulid output _ queue (name=<name>) 
Cstatuse<status variable>] 


name: This perameter specifies the file name of the file 

representing the output. An attempt is made to 
process the specified file within the catalog path 
of where job output queues are known to reside. 


status? See ERROR HANDLING. 


4.8 ROUTE_AN_INSUT FILE FROM C1zo_TO.¢€180 


Through the system consoles enter: 
Type 


XeDIS. 

USERsAsBe 

GETsfilename. 

where fifename identifies the input file to be routed. 
ROUTEsfitenames DC =LP,FC2=RH. 


409 K.DISPLAY ASCII 


Support of 6-12 ASCII from the console (K display) causes 
the following changes? 


INPUT IRANSLATED.10 INPUT IRANSLATED_1T9 
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41 
42 
13 
1% 


wi yp we om me 8 


. (underscore) 


i c 
1) ] 
i+ > 
/~ < 
‘ 
/ 
3 
a 


reversed /) jx 


/* 
4/ 
/» 
JA to /Z 


(single quote) 


- z {lower case) 


4.10 DSOL_INEQRMATION 


To create an Express Deadstart Dump (EDD) tape: 


1). 


2) 
3) 
4) 
5) 


6) 


7) 
8) 


9) 


Mount scratch tape (ring In) on a 9-track drive. 
Push D/S button. 

Select U (utilities) display. 

Select — (EDD) display. 

Set channel ($2213). 

Set ECUU (S2=2CluuU) 

E = equipment 


C = 1 for 67X drives 
2 for 66X drives 


uu = unit number of the tape drive to be used. 
Answer “non zero inhibits rewind” with a CR. 
Answer “dump number” with a CR. 

Answer “dump controlware”™ with a CR. 


* - Warning if this step Is omitteds DSDI canot 
process the dump tape, 


To create a listing of the £DD tape: 


1) 


REQUEST sDUMP sNTsD2PE »F2SyLB eKUsPO2R,VSNeyour choices 
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4.0 DUAL STATE 


DEADSTART AND OPERATION 


$210 DSDI INFORMATION 
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2) 


3) 


4) 


3) 


6) 


7) 


GETsDSDI/UN=DEV1. (On SYN 101.) 

or 
GETsDSDI/JUN=DEV1. (On S2.) 
Create DSDI directives file: 
A DSDI directive file should include the following: 
IOUMR, 
PROMR. 
MEMMR. 
PRORF. 
Wefirst_byte_address»stast_byte_adresssaside {where 
the first _byte_address and tast_byte_address are hex 
byte addresses and asid is the asid of the segment to 
be dumped) 
Execute DSDI: 


RFL»60000. 
DSDIsMsDsT="inout directives file", 


To run (after the first time): 

DSDIsI=n. 

(Does not read tape againe) 

To run interactivetys 

Same as aboves except to do W command must first do: 
OUTPUTsLISTFIL. 


C170 DOSDI information can be found in Chapter 10 xof 
the NOS SYSTEM MAINTENANCE Manual. 


A170 DSDI info can be found In document ARH3060 -- GID 
for A170 NOS/S2. 


411 NOSZVE_TERMINATION 


o Bringing down dual state: 


2.0FFSW6. 
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Kean - nis the NVEFFFF control point 
Ke TERMINATE_SYSTEM_ J9B 

o If not a normal termination 
Ksn =~ n is the NVEFFFF control point 
Ke ¥RUNS 


Ke *ENDLST. 
Ke *ENDRUN. 


4012 AL70_NOS_ SHUTDOWN 


Before lteaving the machines it is necessary to bring NOS 
down. If NOS has crasheds a teavel 3 deadstart must be 
attempted even If the only reason is to bring NOS down. To do 
a fevel 3 deadstart: 

1) Push D/S button 

2) Setect "oO" display 
3) Sefect "P" display 
4) Enter [#3 

5) Enter (CR) 

6) Enter date/time 

If a dump is desired but a crash has not occurred STEP. 
should always be entered before pushing the deadstart button. 
After the dump has been taken a tevel 3 deadstart should be 
performed, 

To bring NOS downs do the following? 

1) Enters 
CHE 
The screen will display: 
CHECKPOINT SYSTEM. 
Enter: carriage return 


2) Make sure no mass storage device has aie checkpoint 
rquested. To do thiss enter: EsM. If the display shows 
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there are no "Cs in the status fletd, then = all devices 
are checkpointed and you may continue. 


3) Enter? 
STEP. 


4) Push deadstart button, 
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920 RECOVERY OF _NOS/VE_ PERMANENT_FILES 


Sel SETVE_ FORMAT 


The general format of the SETVE command is 


Xe SETVECPN=F FFF» UNzUns VSN2ySsn»s D2dsP2p 98 =b»C2CyCH#Cch) 


ffff ts a string of no more than four characters. SETVE 


un 


appends ffff to NYE to construct the name of a 
procedure file whichs when invokeds will deadstart 
NOS/VE. The default is TST. 


specifies the user number from which TPXXXK is 
attached, Un is the first catalog searched for 
other files used in deadstarting and terminating 
NOS/VE. The default is INT1. 


specifies the deadstart command deck to be used when 
deadstarting NOS/VE.e The function served by the 
deadstart command deck Is analogous to the function 
served by the CMRDECK of NOS. Currentiy supported 
values for c and their respective uses are: 


Arden Hilts $3 
Arden Hifts S2 open shop/hands on 
Arden Hills S2 closed shop 

0 Sunnyvale S2 closed shop 


hm ny OP 


The default is set in the file CMDS1. Currentiy 
the default is 6. 


Specifies an alternate catalog to be searched for 
the various files used in deadstarting and 
terminating NOS/VE,. The default is INT1. 


is used to indicate that the system core command 
Processor should accept commands from the console. 
Specifying D#T in the SETVE command attows the 
operator to enter commands from the consote after 
processing the deadstart command decke If the 
operator wishes to initialize the system device 
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and/or install anew version of NOS/VEs D=T must be 
specified. The defautt is set in the file CMDS1. 
Currentiy the default is D=F. 


p specifies the password for the catalog indicated by 
the un parameter. If this parameter is omitted the 
password will be generated by appending an 'X*% to 
the UN parameter. 


ch specifies the octal channef to be used for NOS/VE 
disk I70. The default is set in the fite CmDS1. 
Currently the default is 2. 


vsn specifies the vsn of a deadstart tape. If this 
parameter is used then NOS/VE will be deadstarted 
from the tape specified, If it is omitted, than 
NOS/VE will be deadstarted from the permanent file 
TPXXXK. 


5e2 SEIVE_USAGE 


Earlier versions of NOS/VE required that two SETVE commands 
be issued if the system was to be installed and subsequently 
recovered, The current system does not require thise The 
only reason for issuing two SETVE commands tis to provide a 
deadstart procedure that does not require/permit operator 
inter vention. 


It should be noted that once the SETVE command has been 
issueds it need not be issued again unlessee. 


1) There is a need to change one or more of the paerameters 
specified in SETVE. 


2) The command files NVEFFFF, generated by the SETVE 
command is purged from the system. 


Two examples of SETVE usage and subsequent NOS/VE deadstart 
are given below. The first exampie shows a “hands on" user 
working with recovery. The second illustrates these concepts 
for a typical NOS/VE citosed shop. This writer hopes that the 
reader will find both examptes useful and ittuminating. 


Ie A “hands on™ user 


The command file NVERSD Is bul lt and Installed in NOS 
by typing 
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322 SETVE USAGE 


X.SETVECRSDs UN =RS Ds VSN=TAPEs B2DEV1sC 265 DeT ) 


Sev 
noting 


1) 


2) 


3) 


NOS 


Nn 


eral of the choices of parameters are worth 
. 


By specifying the VSN parameter the user has built 
a command file that will deadstart the system 
directly from the tape produced by NVESYS. 


The user in this example has specified deadstart 
command deck 6 (C parameter) and has allowed the 
NOS/VE disk I/O channel (ch parameter) to default 
to 2.2 Qne concludes that the user is running on 
the Arden Hills S2. 


The user has specified DT. This is Important. 
The deadstart command which triggers installation 
of a recoverabie system cannot be read from a 
deadstart command deck. It must be entered from 
the console at deadstart time. Specifying D=T 
allows the operator to enter commands from the 
console. 


4VE is deadstarted by typing 


»NVERSD-. 


at the console. (n is a control point which is NOT ls 2 


or ord 
The us 


7 
The 
K 


(where 


Inarlly occupied by MAGNET, BATCHIOs or SYSTEM) 
er brings up TAFs PASSONs and IRHF by typing 


AFNVE. 
user brings up the K display by typing 
ge 


n is the NVE control point.) 


Presentlys the deadstart command deck is disptayed 
and the user is prompted (for input. The deadstart 


co mman 


USECP 
USEIP 
SETDCT 
SETOD 


The 


d deck used in this example ftooks tike this: 
S2CFIG 
EMPTY 
$7155_1 
$885_12 32 


user types 
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Ii. 


KeINITDD VSNOO]1. 
KeGOe 


The system accepts the commands and instatis and 
deadstarts NOS/VE. 


After the system comes downs via either controtlied 
termination or a crashs the system can be recovered (if 
necessary) and redeadstarted by typing 


nNeNVERSD. (where n is an appropriate control point.) 


When the deadstart command deck is displayeds the 
user types 


GO. 


This will cause NOS/VE to be deadstarted without 
initializing the system device. 


A typical "closed Shop" 


Two command filess NVECLSH and NVEINST,s are created 
by typing 


Xe SETVECCLSHsUN=CLS Hs Ba=DEV1»C =10sCH=1) 
XeSETVECINSTsUNSCLSHsB2D0EVisC =10»CH=1,DT ) 


One notes that 


1) Closed shop is deadstarted from a TPXXXK file in 
the CLSH catalog. 


2) the onty difference between the command fites is 
that NVEINST causes deadstart to pause for 
operator input and NVECLSH does note It is 
intended that NVECLSH be used for normal 
deadstarts. NVEINST is to be used in cases 
requiring operator intervention. 


A normal deadstart is used when bringing up NOS/VE at 
the beginning of closed shop or following a system 
failure. The operators in this examples types 
NeNVECLSH. 

NOS/VE will recover (if necessary) and deadstart. No 
operator intervention is required. 
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If it is necessary to reinitialize the system devices 
or Uf the Installation is upgrading to a new version of 
NOS/VE» the operator keys 


neNVEINST. 


This causes deadstart to pause and wait for operator 
input when deadstart commands are being processed. 
There are two cases requiring discussion here, The 
first is the case of upgrading to a new and compatible 
version of NOS/VE. The second case is used onty when it 
is necessary to reinitialize the system device. 


The first case Involves the Installation of a new 
version of NOS/VE. In order to instali a new version of 
the systems the old system must have been idied in an 
orderly way. A new system cannot be installed if, 
following a crashs the system being superceded was not 
recovered. Assuming everything in the ofd system is 
tidy, and the file systems are compatibles the operator 
keys 


KeSETSA INSTALL_LJOB_LTEMPLATES 1. 

K.GO. 

when the system disptays the deadstart command deck and 
prompts for input. The new system Is installed» the 
file system is preservads and deadstart proceeds. 


The second case amounts to an installation 
deadstart. This should be used only with full knowledge 
that any files which may have existed on mass storage 
he: to this deadstarts wiil_be blasted into oblivion 
by.ife 


An installation deadstart will be required if 


1) This is the Initial installation of a recoverable 
version of NOS/VE. 


2) If the file systems of the system being installed 
and the system being superceded are not 
compatible, 


3) If the file system has been damaged beyond the 
possibility of recovery. 


An instattation deadstart is effected by typing 
KeINITDD VSNOO1. 
Cycle 35 May 1982 


5-6 


NOS/VE Cycle 3 Helpful Hints 


05/24782 


5.0 RECOVERY OF NOS/VE PERMANENT FILES 


5e2 SETVE USAGE 


PO PO AE PO 00 OE 88 88 28 EO PE 8 8 08 08 08 08 88 A EE 98 8 ene ene nee eee rene re ne te ne a0 00 90 70 90 90 00 0 ha 0s te 20 vane mere me tan) rene sae 


KeGO. 


when the deadstart command deck is displayed and the 
operator is promoted for input. 


NOTES: 


1. 


26 


3. 


The CMDS] file used to deadstart NOS/VE must have 
the DEBUG2 flag set to TRUE. When NOS/VE ts 
deadstarted» the catalog specified by the UN 
Parameter is first in the search order for CMDS1>» 
followed by the catalog specified by the B 
par ameter. 


See Section 3.3 of tha Integration Procecures 
Notebook for other Information about the CMDS] 
file, 


If NOS/VE crashes and a dump is desired (in the 
context of our second example) 


i. Type du at the MDD console. The message 


"WRITING IMAGE FILE® should appear 
immediatelye The message “IMAGE FILE 
COMPLETE" should appear a few moments 
later. 


ii. Push the deadstart button. 
jiie Take the EDD dump. 

ive Do a tevel 3 NOS deadstart. 

Alternatively the operator can skip step i If 
she/he is sure to redeadstart NOS/VE after step 
ive In this event the system will detect that the 


image file was never createds will create ones and 
will recover fron it, 
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6060 SYSTEN_CORE DEBUGGER 


The System Core debugger provides a set of capabilities 
Intended to assist in debugging the operating system. 
Services provided by the debugger are task oriented: setection 
of the tasks to be debugged must be made via debugger 
subcommands. No tasks will be under control of the debugger 
untess they are selected. The selection capability allows any 
number of tasks to be debugged simultaneously; from one task 
to all tasks in the system. Obviousty a capability this 
powerful must be used with some cares The System Core 
debugger uses the debug hardware to provide these 
capabilities. 


601 SYSDEBUS 


The purpose of this command is to initiate execution of the 
system core debugger. This command can be Issued from the 
deadstart command file or as a command in any jobe 


sysdebug 


This command has no parameters; all =tnformation the 
debugger requires is provided via subcommands, 


The system core debugger can also be invoked from the MDD 
consolee The format of the command is: 


DO n.sysdebug 
where n is the job ordinal of the desired job. The debugger 
is brought up In the job monitor task of the job. All system 


core debugger subcommands are availables but must be prefixed 
by the MDD command DO. 


602 SUBCOMMAND. PARAMETER.DEEINITIONS 


<name> $38 1-8 cheracter breakpoint name 
€condition> ts READIWRITEIRNISBRANCHS CALLS DIVFLTSARLOS: 
AROVFLIEXOVFL!E EXUNFL?SFPLOSSFPINDEFS INVBDP 
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<base> %%= process virtual address 
<offset> t= integer 

<fength> %:= integer 

<frame> t= 1.22100 

Ccount> 232 1.210000 

<regid> 232 XSAiP 

Cregna> tis 0021550. -0F(16) 
<value> tt2= integer 

€time> 222 1,.2(2%%*31)-1 
Cvstring> 228 'charstring! 
<datatype> tt= HEXSASCIIPASCIDEC 
€change_count> 73#@ 1.28 
€selector> s3:8 FULLI AUTOS SAVE 


663 SYSTEM CORE DEBUGGER SUBCOMMANDS 


Within the descriptions which follows optional parameters 
are enctosed in brackets. Default values for optional 
parameters are also defined. 


623.1 SELECT 


The purpose of this subcommand is to select the tasks in 
which the system core debugger is to be active. When the 
debugger Is first catteds it is not active in any task, To 
use the debugger therefore, it Is necessary to select the 
tasks in which it is to beactive. 


sefect <selection option> (<ring number> { <active job tist 
ordinal>d] 


setection option: This parameter specifies one of a 
series of selection options used to control the 
tasks in which the debugger will be active and some 
other debug options. The setections are remain in 
effect until they are explicitly changed with 
subsequent SELECT subcommands. Valid selection 
options are? 


<rightilteft> - This selects the screen for the debug 
display. The display stays active when the screen 
ts switched. 


<jobmonitorinojobmonitor> - This selects whether or 
not to debug job monitor tasks. 
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<userinouser> - This setects whether or not to debug 
user tasks (i.e. those that are not Jjob 
monitors). 


Chighring> - This specifies the highest ring in 

which debug traps wlll be recognized. Traps 

occurring in rings above this selection will be 
ignored, 


<jobinojob> - This enables or disables debugging for 
the job at the specified active job tist 
ordinal, The system job has an active job list 
ordinal of zero. 


<alitjobsinojobs> - This activates or deactivates 
debugging in all jobs. 


The initiat selections are? RIGHT» NOSTEP » 
NOJOBMONITOR,s NOUSER»s HIGHRING#3,5 NOJOBS. 


6.23.2 BREAKPOINT $ B 


The purpose of this subcommand is to selects a pregram 
interrupt which is to occ specified condition within § a 
specified virtual address range. 


breakpoint <name> <conditiond E<base>] C<offset>] [E<tength>] 


The <name> is any user supptied name for identifying the 
breakpoint, A maximum of thirty two breakpoints can be 
selected, When a trap occurss the <name> of the breakpoint 
which caused the trap is displayed, 


The base parameter is required when specifying e new 
breakpoint name; offset and fength specifications are optional 
in this case. When adding 2 new condition selection to an 
existing breakpoints bases offsets and length parameters may 
not be specified. 


Bases offsets and tength parameters define the desired 
virtual address range: <base> + <offset> yields a 
first-byte-address; first-byte-address + <length> -1 yields a 
last byte address. 

Default parameter values: 
<offset>d: 0 
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€length>: 1 
62343 REMOVE BREAKPOINT ? RB 


The purpose of this subcommand is to deselect a previously 
selected program inte 


remove _breakpoint <name> ([<condition>] 

If onty the name parameter is specified, att conditions 
associated with the breakpoint are deselected and all evidence 
of the breakpoint is removed. If the condition parameter is 
specifieds only that condition is desetected$; howevers if the 


specified condition is thea only condition selecteds all 
evidence of the named breakpoint is removed. 


60364 LIST BREAKPOINT { LB 

The purpose of this subcommand is to provide a fist of 
currentiy setected breakp and associated conditions. 
list breakpoint [<name>] 

If the Name parameter is specifieds information is 
disptayed for the named breakpoint onty., If the name 


parameter is not specifieds information is displayed for all 
currently defined breakpoints. 


603205 CHANGE BREAKPOINT $ CB 

The purpose of this subcommand is to change the virtual 
address range of aprevi specified breakpoint. 
change_breakpoint <name> <base> [E<offset>] (<ltength>] 

Bases offsets and tength parameters define the desired 
virtual address range: <base> + <offset> yields a 
first-byte-address3; first-byte-address + <flength> -] yields a 
fast byte addresse , . 

Default parameter values: 
<offsetd: 0 
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€length>: 1 
6030e6 TRACE BACK 3: TB 


The purpose of this subcommand is to provide information 
relevant to stack frame associated with an interrupted 
procedure and its predecessor procedurese Validation of PVA*s 
is now performed. 


Information displayed for each selected stack frame 
consists of: 


- S§tack frame number} 
- Current P-address of the associated procedure; 


- Virtual address of the start of the stack frame; 
- Virtual address of the stack frame save area, 


trace_back (€<frame>] (C<count>] CFULLi SHORT] 

The frame parameter specifies the number of the first stack 
frame for which information is to be displayed. Stack frame 
number one is associated with the interrupted procedures stack 
frame two is associated with the interrupted procedurets 
predecessor, etcs 


The module name provided on the traceback is usuatty 
correct but not guaranteed, 


The count parameter specifies the total number of stack 
frames for which information is to be displayed. 


Default parameter values? 
<frame>: 1 
<count>: 1 
bede7 DISPLAY _STACK_FRAME 3: DSF 
The purpose of this subcommand is to display selected 
information from a specifi stack frame. 
display_stack_ frame [<frame>] [<selector>] 


The frame parameter specifies the number of the stack frame 
for which information is to be displayed. (Stack frame number 
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one is associated with the interrupted procedures stack frame 
two is associated with the interrupted procedurets 
predecessors etc.) 


The selector psrameter identifies a region of the specified 
stack frame? 


AUTO: Causes the automatic region of the stack frame to be 
displayed. 


SAVES Causes the save area of the stack frame to be 
displayed. 


FULL: Causes both the automatic and save areas of the stack 
frame to be displayed. 


Default parameter vaiues: 

<frame>: 1 

Cselector>? FULL 
603-8 DISPLAY_REGISTER : DR 

The purpose of this subcommand Is to display the contents 

of a specified registe interrupted procedure. 
display _register <regid> (<regno>] [<datatype>] 
Default parameter values? 

<regno>: Oo 

<datatype>: HEX 


60309 DISPLAY_MEMORY $ OM 


The purpose of this subcommand is to display the contents 
of a specified area of virtual memory. Validation of PVA's is 
now performed. 
display_memory <based> [<length>] 

Default parameter values? 


<lengthd: 8 
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623.10 CHANGE_MEMORY | CM 


The purpose of this subcommand Is to set a specified vaiue 
Into a specified toca of virtual memory for a specified number 
of bytes. Validation of PVA*'s fs now performed. 
change_memory <base> <value> <change_count> 
Default parameter values? 


<change_count>: 1 
Se3e1l1l RUN 


The purpose of this subcommand is to invoke program 
execution after a selected » Interrupt has occurred. 


run 
623.12 SUPER_CHANGE_MEMORY ¢ SCM 


The purpose of this subcommand is the same as the change 
memory subcommands that iss to change the contents of virtual 
memory, It differs fron change memory, howevers in that it 
witt change the attributes of the segment to allow memory to 
be writtens and then change the attributes back to their 
original values. 


The command format is the same as the change Memory 
subcommand. 
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7.0 NOSZVE_ PROCESSING OF _ JOB MODE SOFTWARE ERRORS 


Vel INTRODUCTION 


Tasks running in job mode will occasional! y cause an error 
which is detected either by the hardware or NOS/VE monitor. 
The action taken when an error tike this occurs is controlled 
by various system attributes. The purpose of this section is 
to discuss the types of errors and the effect a given syster 
attribute will have upon the handling of the error. 


7o2 TYPES _OF_ ERRORS 


1) BROKEN TASK: A broken task is a task in which the trap 
mechanism is not able to function correctly. NOS/VE 
monitor will attempt to repair the trap mechanism and = send 
a broken task fault to the taske The specific cases of a 
broken task are? 


system error job mode software has 
declared the task to be 
broken. (This is a special 
case of broken task.) 


monitor fault buffer full job mode errors are 
occuring but are not being 
processed by job mode, 


traps disabled a job mode error has 
occurred while traps were 
disabled. 

invalid Ad the task's AG register was 
invalid. 

YCR/MCR traps disabled UCR/MCR error occurred with 


traps disabled, 


2) MCR FAULT: This error signifies that job mode caused a 
hardware detected MCR faulte This may be caused by 
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software or hardware detected uncorrectable error. 


3) UNKNOWN SYSTEM REQUEST: This error signifies that job mode 
issued a monitor request that is either invalid or cannot 
be issued from the ring it was issued frome 


4) SEGMENT ACCESS FAULTS! These errors signify that job mode 
encountered or caused one of the following errors: 


- page fault for an address greater than EDI on 4a 
read-only file (segment) 


- disk read error 


These errors either originate in NOS/VE monitor ofr cause 
the hardware to exchange to monitor. Depending on the vaiues 
of certain system attributess monitor will halt or reflect the 
error back to job mode as a monitor default, 


It Is at this point that the system core debugger cen be 
activated. (See the definition of SYSTEM _DEBUG_RING in the 
next section.) 


The normal job mode 9S actions for these fauits are: 


broken task exit 
MCR fault cause condition 
invalid system request exit 
segment access cause condition 


703 SYSTEM ATIRIBULES_EOR_ ERROR PROCESSING 


The fottlowing system attributes can be set or displayed ody 
the SETSA and DISSA commands, 


7e3e1 HALTRING 


If a broken task or MCR fault occurs at or below the value 
of HALTRING (P register ring number)» NOS/VE monitor will halt 
the system. Broken tasks occurring above HALTRING will cause 
a monitor fault to be sent back to job mode. 
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76322 SYSTEMLERROR HANG COUNT 


This is the number of broken task errors attowed to occur 
In any given task before that task is considered a hung task. 


70303 HALT_ON_HUNG_TASK 


If this attribute Is trues then an occurence of a hung task 
will cause NOS/VE monitor to halit the system. If the 
attribute is false» the task will be sent a signal to ‘hang? 
itsei fs i.e. to go into an infinite wait doing nothing. Jobs 
with hung tasks will have a *H in the status field on the 
operator CP display. 


A hung task will atso occur If any error happens in job 
mode ring 1. 


70304 SYSTEM_DEBUG_RING 


If an error (broken tasks MCR fault, unknown system 
request», or segment access fault) occurs at or betow the value 
of this attribute (P register ring number)» the system core 
debugger will be invoked within the task. At that point in 
time the task environment can be examined by using system core 
debugger commands. 


If the RUN command is issued to the debuggers the system 
witt) take its normal action for the specific fault, 
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B20 STANDALONE DEADSTARI 


Standalone deadstart does not work for Cycle 3. Code will 
be transmitted for Cycle 4 to repair this; this section will 
be rewritten then. 
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9.0 INTERACTIVE PROJECT DUMP _ ANALYSIS PROCEDURES 


The foltowing procedures were developed by the interactive 
project to assist them in interpreting dumpse They guarantee 
the procedures work if your user name is IFP3 otherwise caveat 
emptore For more information about these proceduress contact 
Fred Bischke. 


The following dump analysis procedures are availabte in the 
IFP catalogs: 


9.1 
ENDSIM 
This fs a CCL procedure which brings an EDD dump tape on a 


speci fied | 


VSN into the simulator. The procedure can be accessed from 
the IFP 


catalog as foltows: 
get,eddsim/unzifp 


beginsseddsimsvsn ( vsn is the vsn of the EDD dump tape ) 


9.2 

ANALEXC 

This is a Simuttator INCLUDE file which does a preliminary 
analysis of 

the current simulator exchange package ( when the § syster 


crashes in task 
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9.0 INTERACTIVE PROJECT DUMP ANALYSIS PROCEDURES 
922 


servicess this wil! normatty be JPS ). <A ar excemon or ar 
excerma can be 


used to get into another exchange package before doing the 
Includes 


The Inctude file is ANALEXC/UN#IFP, It can be called from 
the simulator 


as follows: 
*getsanatexc/unsifp! 3; include analexc 


(carrlage return) a tone carrtlage return must be entered 
after an INCLUDE 
in order to start it up 


9-3 
SEGDUMP 


This fs a CCL procedure which calits ODSDIV to dump a 
specified segment to 
a fist file which can then be examined with an editor or 
printed. 
The procedure can be accessed from within the Simulator as 
follows: 
'getssegdump/unesifo® 3; theginsssegdumpssegsiensfilesexcycpft 


The segdump parameters are? 
seg ~ segment number in hex ( default is 1 ) 
fength - number of bytes to dump in hex ( default Is 10000 ) 
list - name of the list file ( defauit is LIST ) 
exc - reference exchange package ( default is JPS ) 
cpf ~- name of checkpoint file ( default Is CPF ) 
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In most cases of task services debuggings, only the seg 
parameter is 


needed. 
9.4 
ANAL JOB 
This is a CCL procedure which uses ODSDIVs, XEDIT and the 


Simulator to 


perform an anatysis of all tasks tn a specified job. The 
procedure can 


be accessed from within the simulator as follows: 
'getsanaljob/unzifp' 3 "heginssanal Jobssegscpf? 


The analjob parameters are? 
seg - the monitor segment which contains the exchange 
packages of the job (14 Is the system jobs 15 is job 1 etce 
»’ ( default Is 14 ) 
cpf - the name of the simulator file ( default is CPF ) 
After the procedure has completeds a tist of the RMA's of 
the 
job's exchange packages can be obtained by doing the 
fottoning? 
inciude tplist 


(carriage return) 


A traceback of all tasks in the job can be obtained by 
doing the 
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following: 
include tblist 
{carriage return) 


include tbrun 


(carriage return) 
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10-0 ARDEN_HILLS DEVELOPMENT LAB SUPPORT _BY_ INTEGRATION 


What we have established in the lab so far is the following: 


A 600 tape capacity tape rack for general use. If your 
project would tike to reserve a saction of this tape racks 
contact Tim McGibbon or Bonnie Swierzbin 


A tape and disk cabinet for storage of system support 
materials which this project will manage and keep up to 
date@e (If you have been using this cabinet for 
unauthorized storage — beware. We have the key to the 
lock!) More will be published about the contents cf this 
cabinet tater, and a cabinet index will be posted in the 
jab to help locate where things are supposed to be placed 
within the cabinet. This cabinet is currently located in 
the southeast corner of the labs is 6 ft. 8 In, tatls 
gray In color and with sliding door. 


A microfiche reader and a metal box containing the most 
recent microfiche of the system compitation tistings and a 
fink map. These items are kept on the table to the right 
of the console, 


A desk documentation rack for reference manyals and Tom 
McGee's collection of "how to" goodies. The objective is 
to heave this reference information at arm's length of the 
consoles but it is currently on top of the two-level unit 
by the West wall. 


At or near the consote ts a small notebook containing the 
NOS System Programmer's Instants NOS Application 
Programmer's Instants and the 180 Instruction codes. 


Feel free to examine and use all of the above materiats white 
in the tab. 


Do not remove or abuse any of these materials. 


Please notify Tim McGibbon or Bonnie Swierzbin of any 
probiems or deficiencies of these materials. Leave a note if 
we are not available, 
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APPENDIX_A_NOS/VE BACKGROUND DOCUMENTS 


1-0 Hardware Overview 


1-1 AN introduction to CYBER 180 

1.2 C€186 Instant 

1.3 Model Independent General Design Specification - 
ARH1700 


22.9 NOS Reference Manyals 


2el XEDIT y3.C — 60455730 

202 IAF V1.0 User's Guide = 60455260 

203 NOS Reference Manual - Vol ls 60435400 - Vol 2, 
60445300 

24 NOS Instant 

205 NOS Operators Guide - 60435600 

2e6 NOS Diagnostic Handbook 

207 NOS A170 ERS 

208 NOS A170 GID - ARH3060 


320 NOS/VE Reference Documents 


3.1 


302 


304 


Program Interface ERS =- ARH3610 =~ obtained from Karen 
Rubey (482-3966) or via SES-TOOLDOC 


Command Interface ERS —- ARH3609 — obtained from Karen 
Rubey (482-3966) or via SES.TOOLDOC 


NOS/VE Procedures and Conventions = SESDO10 —- obtained 
by SES. TOOLDOC : 


Listing of ati NOS/VE Modules - obtained by 
SES,»,DEVI.~LISTNVE. See Integration Procedures Notebook 
for details. 
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325 NOS/VE Internal Interface Maintenance Procedures 


Memo avallable from $eCe Woods 


Integration Procedures Notebook 
Obtained by? 


AcquiresIPNDOC/UN#DEV1. SES.sPRINTsIPNDOC,. 


4e0 Tools Reference Documents 

4.1 CYBIL Interactive Debugger - ARH3142 
4.2 SES User's Guide - ARH1833 

4.3 CYBIL Specification - ARH2298 
4.4 C180 assembler ERS —- ARH1693 

405 Simylator ERS - ARH1729 

4.6 VEGEN ERS ~ ARH2591 

4.7 VELINK ERS — ARH2816 

4.8 Simulated I70 ERS - ARH3125 

4.9 Object Code Utilities ERS =- ARH2922 
4,10 CYBIL Imptementation Dependent Handbook - ARH3078 


4.11 CYBER 180 INTERACTIVE DEBUG External Reference 
Specification and Users Guide - $4028 
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